commit: e74aefc1289d063111dd817ae90251170673cd04 Author: Brian Dolbec <dolsen <AT> gentoo <DOT> org> AuthorDate: Wed Apr 30 15:47:23 2014 +0000 Commit: Brian Dolbec <brian.dolbec <AT> gmail <DOT> com> CommitDate: Mon Sep 29 17:20:20 2014 +0000 URL: http://sources.gentoo.org/gitweb/?p=proj/portage.git;a=commit;h=e74aefc1
man: Update man pages with new sync info man/portage.5: Add the new auto-sync variable. man/emaint.1: Add the new sync module. man/emerge.1: Update the --sync action. --- man/emaint.1 | 15 ++++++++++++++- man/emerge.1 | 8 +++++++- man/portage.5 | 10 ++++++++++ 3 files changed, 31 insertions(+), 2 deletions(-) diff --git a/man/emaint.1 b/man/emaint.1 index 8356299..f02bc68 100644 --- a/man/emaint.1 +++ b/man/emaint.1 @@ -37,6 +37,9 @@ Perform package move updates for binary packages located in \fBPKGDIR\fR. .BR moveinst Perform package move updates for installed packages. .TP +.BR sync +Perform sync actions on specified repositories. +.TP .BR world Fix problems in the \fIworld\fR file. .SH DEFAULT OPTIONS @@ -46,7 +49,7 @@ Check for any problems that may exist. (all commands) .TP .B \-f, \-\-fix Fix any problems that may exist. (not all commands) -.SH OPTIONS +.SH OPTIONS logs command .TP .B \-C, \-\-clean Cleans the logs from \fBPORT_LOGDIR\fR (logs command only) @@ -58,6 +61,16 @@ OPTION (logs command only) .B \-t NUM, \-\-time NUM Changes the minimum age \fBNUM\fR (in days) of the logs to be listed or deleted. (logs command only) +.SH OPTIONS sync command +.TP +.B \-a, \-\-auto +Sync repositories which have its auto\-sync setting set yes, true. (sync command only) +.TP +.B \-A, \-\-allrepos +Sync all repositories which have a sync\-uri specified. (sync command only) +.TP +.B \-r, \-\-repo REPO +Sync the repository specified. (sync command only) .SH "REPORTING BUGS" Please report bugs via http://bugs.gentoo.org/ .SH AUTHORS diff --git a/man/emerge.1 b/man/emerge.1 index a2cb3f6..52aff95 100644 --- a/man/emerge.1 +++ b/man/emerge.1 @@ -240,7 +240,7 @@ the package name. \fBTake caution\fR as the descriptions are also matched as regular expressions. .TP .BR \-\-sync -Updates repositories, for which sync\-type and sync\-uri attributes are +Updates repositories, for which auto\-sync, sync\-type and sync\-uri attributes are set in repos.conf. See \fBportage\fR(5) for more information. The \fBPORTAGE_SYNC_STALE\fR variable configures warnings that are shown when emerge \-\-sync has not @@ -251,6 +251,12 @@ The emerge \-\-sync action will revert local changes (e.g. modifications or additions of files) inside repositories synchronized using rsync. \fBNOTE:\fR +The emerge \-\-sync command is a compatibility command. Sync operations are +now performed using the the new emaint sync module. This new emaint sync module +has greater functionality and flexibility. Please refer to \fBemaint(1)\fR for +more information about sync operations. + +\fBNOTE:\fR The \fBemerge\-webrsync\fR program will download the entire portage tree as a tarball, which is much faster than emerge \-\-sync for first time syncs. diff --git a/man/portage.5 b/man/portage.5 index e399f0f..efafc27 100644 --- a/man/portage.5 +++ b/man/portage.5 @@ -818,6 +818,16 @@ When 'force = aliases' attribute is not set, \fBegencache\fR(1), since operations performed by these tools are inherently \fBnot\fR \fIsite\-specific\fR. .TP +.B auto\-sync +This setting determines if the repo will be synced during "\fBemerge \-\-sync\fR" or +"\fBemaint sync \-\-auto\fR" runs. This allows for repositories to be synced only when +desired via "\fBemaint sync \-\-repo foo\fR". +.br +Valid values: yes, no, true, false. +.br +If unset, the repo will be treated as set +no, false. +.TP .B eclass\-overrides Makes given repository inherit eclasses from specified repositories. .br
