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 52C2C138CA3 for ; Wed, 4 Mar 2015 20:39:57 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id DC3A5E097C; Wed, 4 Mar 2015 20:39:56 +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 5EDFBE097C for ; Wed, 4 Mar 2015 20:39:56 +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 461E7340771 for ; Wed, 4 Mar 2015 20:39:55 +0000 (UTC) Received: from localhost.localdomain (localhost [127.0.0.1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id 6CCFC130B3 for ; Wed, 4 Mar 2015 20:39:51 +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: <1425501485.44f2a48390909050dd42404de9136bf78c97928e.dolsen@gentoo> Subject: [gentoo-commits] proj/portage:master commit in: man/ X-VCS-Repository: proj/portage X-VCS-Files: man/emaint.1 X-VCS-Directories: man/ X-VCS-Committer: dolsen X-VCS-Committer-Name: Brian Dolbec X-VCS-Revision: 44f2a48390909050dd42404de9136bf78c97928e X-VCS-Branch: master Date: Wed, 4 Mar 2015 20:39:51 +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: 2c2cf785-992b-4fbc-ad52-0ca43175ef81 X-Archives-Hash: 9ca16903aaa757ea8307e80ccfc9c71a commit: 44f2a48390909050dd42404de9136bf78c97928e Author: Brian Dolbec gentoo org> AuthorDate: Sat Feb 28 23:45:29 2015 +0000 Commit: Brian Dolbec gentoo org> CommitDate: Wed Mar 4 20:38:05 2015 +0000 URL: http://sources.gentoo.org/gitweb/?p=proj/portage.git;a=commit;h=44f2a483 emaint.1: Update man page for better clarity (540482) As recommended by Duncan on the gentoo-portage-dev list. Clarify the all command. Add OPTIONS to all commands, so a user can determine which modules may run when the 'all' command is used. Remove repetitive '(* command only)' text by adding it to the section header. man/emaint.1 | 43 ++++++++++++++++++++++++++++++------------- 1 file changed, 30 insertions(+), 13 deletions(-) diff --git a/man/emaint.1 b/man/emaint.1 index c97945f..9d8de55 100644 --- a/man/emaint.1 +++ b/man/emaint.1 @@ -12,75 +12,92 @@ management health checks and maintenance. .SH COMMANDS .TP .BR all -Perform all supported commands. +Perform all supported commands that accept the specified option. .TP .BR binhost Generate a metadata index for binary packages located in \fBPKGDIR\fR (for download by remote clients). See the \fBPORTAGE_BINHOST\fR documentation in the \fBmake.conf\fR(5) man page for additional information. +.br +OPTIONS: check, fix .TP .BR cleanconfig Discard no longer installed config tracker entries. +.br +OPTIONS: check, fix .TP .BR cleanresume Discard merge lists saved for the \fBemerge\fR(1) \fB--resume\fR action. +.br +OPTIONS: check, fix .TP .BR logs Clean out old logs from the \fBPORT_LOGDIR\fR using the command \fBPORT_LOGDIR_CLEAN\fR See the \fBmake.conf\fR(5) man page for additional information as well as enabling the \fB'clean-logs'\fR feature in emerge to do this automatically. +.br +OPTIONS: check, clean .TP .BR merges Scan for failed package merges and attempt to fix those failed packages. +.br +OPTIONS: check, fix, purge .TP .BR movebin Perform package move updates for binary packages located in \fBPKGDIR\fR. +.br +OPTIONS: check, fix .TP .BR moveinst Perform package move updates for installed packages. +.br +OPTIONS: check, fix .TP .BR sync Perform sync actions on specified repositories. +.br +OPTIONS: allrepos, auto, repo .TP .BR world Fix problems in the \fIworld\fR file. -.SH DEFAULT OPTIONS +.br +OPTIONS: check, fix +.SH DEFAULT OPTIONS (Not supported in all commands) .TP .B \-c, \-\-check -Check for any problems that may exist. (all commands) +Check for any problems that may exist. .TP .B \-f, \-\-fix -Fix any problems that may exist. (not all commands) -.SH OPTIONS logs command +Fix any problems that may exist. +.SH OPTIONS logs command only .TP .B \-C, \-\-clean -Cleans the logs from \fBPORT_LOGDIR\fR (logs command only) +Cleans the logs from \fBPORT_LOGDIR\fR .TP .B \-p, \-\-pretend Sets pretend mode (same as \-c, \-\-check) for use with the \-C, \-\-clean -OPTION (logs command only) +OPTION .TP .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 +deleted. +.SH OPTIONS sync command only .TP .B \-a, \-\-auto -Sync repositories which have its auto\-sync setting set yes, true. (sync command only) +Sync repositories which have its auto\-sync setting set yes, true. .TP .B \-A, \-\-allrepos -Sync all repositories which have a sync\-uri specified. (sync command only) +Sync all repositories which have a sync\-uri specified. .TP .B \-r, \-\-repo REPO -Sync the repository specified. (sync command only) +Sync the repository specified. .TP .BR "\-\-sync-submodule " Restrict sync to the specified submodule(s). This option may be specified multiple times, in order to sync multiple submodules. Currently, this option has no effect for sync protocols other than rsync. -(sync command only) .SH "REPORTING BUGS" Please report bugs via http://bugs.gentoo.org/ .SH AUTHORS