aboutsummaryrefslogtreecommitdiff
path: root/man/reposync.8
diff options
context:
space:
mode:
Diffstat (limited to 'man/reposync.8')
-rw-r--r--man/reposync.851
1 files changed, 51 insertions, 0 deletions
diff --git a/man/reposync.8 b/man/reposync.8
new file mode 100644
index 0000000..bed67c3
--- /dev/null
+++ b/man/reposync.8
@@ -0,0 +1,51 @@
+.\" -*- mode: troff; coding: utf-8 -*-
+.TH REPOSYNC 8
+.SH NAME
+reposync \- synchronize git-based package repositories
+.SH DESCRIPTION
+.LP
+\fBreposync\fR synchronizes git-based package repositories using environment
+variables for configuration. It does not depend on an \fIapkg.conf\fR file.
+.SH OPTIONS
+.TP
+\fB-n\fR
+Dry-run: print actions without executing them.
+.TP
+\fB-l\fR
+Enable logging to \fI/var/log/reposync.log\fR.
+.TP
+\fB-f\fR
+Force sync: remove existing repo directories before cloning fresh.
+.TP
+\fB-h\fR
+Print usage message.
+.SH ENVIRONMENT VARIABLES
+.LP
+Repository configuration is provided via variables with the \fBREPOSYNC_\fR prefix.
+Each variable's value uses the pipe-delimited format:
+\fI<url>|<branch>|<local-path>\fR.
+.PP
+For example:
+.PP
+\f(CRREPOSYNC_CORE="https://codeberg.org/emmett1/alicelinux.git|main|/var/lib/alicelinux"\fR
+.PP
+\f(CRREPOSYNC_EXTRA="https://codeberg.org/emmett1/alicelinux.git|extra|/var/lib/alicelinux/extra"\fR
+.SH EXAMPLES
+.LP
+\f(CRreposync\fR - Sync all repos configured via REPOSYNC_* variables.
+.PP
+\f(CRreposync -n\fR - Dry-run to see what actions would be taken.
+.PP
+\f(CRreposync -l\fR - Sync with logging enabled.
+.PP
+\f(CRreposync -f\fR - Force fresh clones of all repositories.
+.SH AUTHORS
+.LP
+emmett1 \c
+.MT me@emmett1.my
+.ME
+.SH REPORTING BUGS
+.LP
+Please report bugs and issues in the project issue tracker: \c
+.UR https://codeberg.org/emmett1/autils/issues
+.UE