1 |
commit: fe42f2a99297fed36720e71ba2ed77cf7a9da804 |
2 |
Author: Fabian Groffen <grobian <AT> gentoo <DOT> org> |
3 |
AuthorDate: Sat Mar 31 19:04:20 2018 +0000 |
4 |
Commit: Fabian Groffen <grobian <AT> gentoo <DOT> org> |
5 |
CommitDate: Sat Mar 31 19:04:20 2018 +0000 |
6 |
URL: https://gitweb.gentoo.org/proj/portage-utils.git/commit/?id=fe42f2a9 |
7 |
|
8 |
man/qlop: add some more/better documentation |
9 |
|
10 |
Bug: https://bugs.gentoo.org/335453 |
11 |
Bug: https://bugs.gentoo.org/367199 |
12 |
|
13 |
man/qlop.1 | 40 +++++++++++++++++++++++----------------- |
14 |
1 file changed, 23 insertions(+), 17 deletions(-) |
15 |
|
16 |
diff --git a/man/qlop.1 b/man/qlop.1 |
17 |
index f8f0cdd..70fb411 100644 |
18 |
--- a/man/qlop.1 |
19 |
+++ b/man/qlop.1 |
20 |
@@ -1,57 +1,63 @@ |
21 |
-.TH qlop "1" "Mar 2016" "Gentoo Foundation" "qlop" |
22 |
+.TH qlop "1" "Mar 2018" "Gentoo Foundation" "qlop" |
23 |
.SH NAME |
24 |
qlop \- emerge log analyzer |
25 |
.SH SYNOPSIS |
26 |
.B qlop |
27 |
\fI[opts] <pkgname>\fR |
28 |
.SH DESCRIPTION |
29 |
- |
30 |
+qlop reads from $EMERGE_LOG_DIR/emerge.log and tries to extract |
31 |
+information about merges, unmerges and syncs. For packages, it can |
32 |
+calculate average merge times or just list them. |
33 |
.SH OPTIONS |
34 |
.TP |
35 |
\fB\-g\fR, \fB\-\-gauge\fR |
36 |
-Gauge number of times a package has been merged |
37 |
+Gauge number of times a package has been merged. This shows the merge |
38 |
+time for each individual merge of package. |
39 |
.TP |
40 |
\fB\-t\fR, \fB\-\-time\fR |
41 |
-Calculate merge time for a specific package |
42 |
+Calculate merge time for a specific package. This is the average time |
43 |
+for all merges of package. |
44 |
.TP |
45 |
\fB\-H\fR, \fB\-\-human\fR |
46 |
-Print seconds in human readable format (needs -t) |
47 |
+Print seconds in human readable format (needs -t), using minutes, hours |
48 |
+and days instead of just seconds. |
49 |
.TP |
50 |
\fB\-l\fR, \fB\-\-list\fR |
51 |
-Show merge history |
52 |
+Show merge history. |
53 |
.TP |
54 |
\fB\-u\fR, \fB\-\-unlist\fR |
55 |
-Show unmerge history |
56 |
+Show unmerge history. |
57 |
.TP |
58 |
\fB\-s\fR, \fB\-\-sync\fR |
59 |
-Show sync history |
60 |
+Show sync history. |
61 |
.TP |
62 |
\fB\-c\fR, \fB\-\-current\fR |
63 |
-Show current emerging packages |
64 |
+Show current emerging packages. This relies on FEATURES=sandbox in |
65 |
+order to detect running merges. |
66 |
.TP |
67 |
\fB\-d\fR \fI<arg>\fR, \fB\-\-date\fR \fI<arg>\fR |
68 |
-Limit selection to this time (1st -d is start, 2nd -d is end) |
69 |
+Limit selection to this time (1st -d is start, 2nd -d is end). |
70 |
.TP |
71 |
\fB\-f\fR \fI<arg>\fR, \fB\-\-logfile\fR \fI<arg>\fR |
72 |
-Read emerge logfile instead of $EMERGE_LOG_DIR/emerge.log |
73 |
+Read emerge logfile instead of $EMERGE_LOG_DIR/emerge.log. |
74 |
.TP |
75 |
\fB\-\-root\fR \fI<arg>\fR |
76 |
-Set the ROOT env var |
77 |
+Set the ROOT env var. |
78 |
.TP |
79 |
\fB\-v\fR, \fB\-\-verbose\fR |
80 |
-Make a lot of noise |
81 |
+Print package versions and revisions. |
82 |
.TP |
83 |
\fB\-q\fR, \fB\-\-quiet\fR |
84 |
-Tighter output; suppress warnings |
85 |
+Tighter output; suppress warnings. |
86 |
.TP |
87 |
\fB\-C\fR, \fB\-\-nocolor\fR |
88 |
-Don't output color |
89 |
+Don't output color. |
90 |
.TP |
91 |
\fB\-h\fR, \fB\-\-help\fR |
92 |
-Print this help and exit |
93 |
+Print this help and exit. |
94 |
.TP |
95 |
\fB\-V\fR, \fB\-\-version\fR |
96 |
-Print version and exit |
97 |
+Print version and exit. |
98 |
|
99 |
.SH "REPORTING BUGS" |
100 |
Please report bugs via http://bugs.gentoo.org/ |