From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) by finch.gentoo.org (Postfix) with ESMTP id 3F38C13877A for ; Fri, 5 Sep 2014 21:16:00 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 885FFE0B66; Fri, 5 Sep 2014 21:15:55 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 56D48E0B6B for ; Fri, 5 Sep 2014 21:15:54 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id ABF0834003C for ; Fri, 5 Sep 2014 21:15:52 +0000 (UTC) Received: from localhost.localdomain (localhost [127.0.0.1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 9160E4CEB for ; Fri, 5 Sep 2014 21:15:48 +0000 (UTC) From: "Brian Dolbec" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Brian Dolbec" Message-ID: <1409948773.2c942d51e1e74dceca6af49679cd7d5a97faccd8.dol-sen@gentoo> Subject: [gentoo-commits] proj/portage:plugin-sync commit in: man/ X-VCS-Repository: proj/portage X-VCS-Files: man/emaint.1 man/emerge.1 man/portage.5 X-VCS-Directories: man/ X-VCS-Committer: dol-sen X-VCS-Committer-Name: Brian Dolbec X-VCS-Revision: 2c942d51e1e74dceca6af49679cd7d5a97faccd8 X-VCS-Branch: plugin-sync Date: Fri, 5 Sep 2014 21:15:48 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Archives-Salt: cf5f05d5-ffb7-4462-b923-046b970c6564 X-Archives-Hash: ccfafe4268f5806fbbe3c8ad71927387 commit: 2c942d51e1e74dceca6af49679cd7d5a97faccd8 Author: Brian Dolbec gentoo org> AuthorDate: Wed Apr 30 15:47:23 2014 +0000 Commit: Brian Dolbec gmail com> CommitDate: Fri Sep 5 20:26:13 2014 +0000 URL: http://sources.gentoo.org/gitweb/?p=proj/portage.git;a=commit;h=2c942d51 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 e32bb43..f197984 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