1 |
commit: 44f2a48390909050dd42404de9136bf78c97928e |
2 |
Author: Brian Dolbec <dolsen <AT> gentoo <DOT> org> |
3 |
AuthorDate: Sat Feb 28 23:45:29 2015 +0000 |
4 |
Commit: Brian Dolbec <dolsen <AT> gentoo <DOT> org> |
5 |
CommitDate: Wed Mar 4 20:38:05 2015 +0000 |
6 |
URL: http://sources.gentoo.org/gitweb/?p=proj/portage.git;a=commit;h=44f2a483 |
7 |
|
8 |
emaint.1: Update man page for better clarity (540482) |
9 |
|
10 |
As recommended by Duncan on the gentoo-portage-dev list. |
11 |
Clarify the all command. |
12 |
Add OPTIONS to all commands, so a user can determine which modules |
13 |
may run when the 'all' command is used. |
14 |
Remove repetitive '(* command only)' text by adding it to the section header. |
15 |
|
16 |
man/emaint.1 | 43 ++++++++++++++++++++++++++++++------------- |
17 |
1 file changed, 30 insertions(+), 13 deletions(-) |
18 |
|
19 |
diff --git a/man/emaint.1 b/man/emaint.1 |
20 |
index c97945f..9d8de55 100644 |
21 |
--- a/man/emaint.1 |
22 |
+++ b/man/emaint.1 |
23 |
@@ -12,75 +12,92 @@ management health checks and maintenance. |
24 |
.SH COMMANDS |
25 |
.TP |
26 |
.BR all |
27 |
-Perform all supported commands. |
28 |
+Perform all supported commands that accept the specified option. |
29 |
.TP |
30 |
.BR binhost |
31 |
Generate a metadata index for binary packages located in \fBPKGDIR\fR (for |
32 |
download by remote clients). See the \fBPORTAGE_BINHOST\fR documentation in |
33 |
the \fBmake.conf\fR(5) man page for additional information. |
34 |
+.br |
35 |
+OPTIONS: check, fix |
36 |
.TP |
37 |
.BR cleanconfig |
38 |
Discard no longer installed config tracker entries. |
39 |
+.br |
40 |
+OPTIONS: check, fix |
41 |
.TP |
42 |
.BR cleanresume |
43 |
Discard merge lists saved for the \fBemerge\fR(1) \fB--resume\fR action. |
44 |
+.br |
45 |
+OPTIONS: check, fix |
46 |
.TP |
47 |
.BR logs |
48 |
Clean out old logs from the \fBPORT_LOGDIR\fR using the command |
49 |
\fBPORT_LOGDIR_CLEAN\fR |
50 |
See the \fBmake.conf\fR(5) man page for additional information as well as |
51 |
enabling the \fB'clean-logs'\fR feature in emerge to do this automatically. |
52 |
+.br |
53 |
+OPTIONS: check, clean |
54 |
.TP |
55 |
.BR merges |
56 |
Scan for failed package merges and attempt to fix those failed packages. |
57 |
+.br |
58 |
+OPTIONS: check, fix, purge |
59 |
.TP |
60 |
.BR movebin |
61 |
Perform package move updates for binary packages located in \fBPKGDIR\fR. |
62 |
+.br |
63 |
+OPTIONS: check, fix |
64 |
.TP |
65 |
.BR moveinst |
66 |
Perform package move updates for installed packages. |
67 |
+.br |
68 |
+OPTIONS: check, fix |
69 |
.TP |
70 |
.BR sync |
71 |
Perform sync actions on specified repositories. |
72 |
+.br |
73 |
+OPTIONS: allrepos, auto, repo |
74 |
.TP |
75 |
.BR world |
76 |
Fix problems in the \fIworld\fR file. |
77 |
-.SH DEFAULT OPTIONS |
78 |
+.br |
79 |
+OPTIONS: check, fix |
80 |
+.SH DEFAULT OPTIONS (Not supported in all commands) |
81 |
.TP |
82 |
.B \-c, \-\-check |
83 |
-Check for any problems that may exist. (all commands) |
84 |
+Check for any problems that may exist. |
85 |
.TP |
86 |
.B \-f, \-\-fix |
87 |
-Fix any problems that may exist. (not all commands) |
88 |
-.SH OPTIONS logs command |
89 |
+Fix any problems that may exist. |
90 |
+.SH OPTIONS logs command only |
91 |
.TP |
92 |
.B \-C, \-\-clean |
93 |
-Cleans the logs from \fBPORT_LOGDIR\fR (logs command only) |
94 |
+Cleans the logs from \fBPORT_LOGDIR\fR |
95 |
.TP |
96 |
.B \-p, \-\-pretend |
97 |
Sets pretend mode (same as \-c, \-\-check) for use with the \-C, \-\-clean |
98 |
-OPTION (logs command only) |
99 |
+OPTION |
100 |
.TP |
101 |
.B \-t NUM, \-\-time NUM |
102 |
Changes the minimum age \fBNUM\fR (in days) of the logs to be listed or |
103 |
-deleted. (logs command only) |
104 |
-.SH OPTIONS sync command |
105 |
+deleted. |
106 |
+.SH OPTIONS sync command only |
107 |
.TP |
108 |
.B \-a, \-\-auto |
109 |
-Sync repositories which have its auto\-sync setting set yes, true. (sync command only) |
110 |
+Sync repositories which have its auto\-sync setting set yes, true. |
111 |
.TP |
112 |
.B \-A, \-\-allrepos |
113 |
-Sync all repositories which have a sync\-uri specified. (sync command only) |
114 |
+Sync all repositories which have a sync\-uri specified. |
115 |
.TP |
116 |
.B \-r, \-\-repo REPO |
117 |
-Sync the repository specified. (sync command only) |
118 |
+Sync the repository specified. |
119 |
.TP |
120 |
.BR "\-\-sync-submodule <glsa|news|profiles>" |
121 |
Restrict sync to the specified submodule(s). This option may be |
122 |
specified multiple times, in order to sync multiple submodules. |
123 |
Currently, this option has no effect for sync protocols other |
124 |
than rsync. |
125 |
-(sync command only) |
126 |
.SH "REPORTING BUGS" |
127 |
Please report bugs via http://bugs.gentoo.org/ |
128 |
.SH AUTHORS |