1 |
commit: 23b810c84c02a29f3b2766cf0fd005c53e668816 |
2 |
Author: Fabian Groffen <grobian <AT> gentoo <DOT> org> |
3 |
AuthorDate: Tue Apr 3 13:51:42 2018 +0000 |
4 |
Commit: Fabian Groffen <grobian <AT> gentoo <DOT> org> |
5 |
CommitDate: Tue Apr 3 13:51:42 2018 +0000 |
6 |
URL: https://gitweb.gentoo.org/proj/portage-utils.git/commit/?id=23b810c8 |
7 |
|
8 |
qtbz2: improve documentation |
9 |
|
10 |
Bug: https://bugs.gentoo.org/645554 |
11 |
|
12 |
man/include/qsize.desc | 3 +++ |
13 |
man/include/qsize.optdesc.yaml | 5 +++++ |
14 |
man/include/qtbz2.desc | 2 ++ |
15 |
man/include/qtbz2.optdesc.yaml | 2 ++ |
16 |
man/qtbz2.1 | 33 ++++++++++++++++++--------------- |
17 |
5 files changed, 30 insertions(+), 15 deletions(-) |
18 |
|
19 |
diff --git a/man/include/qsize.desc b/man/include/qsize.desc |
20 |
new file mode 100644 |
21 |
index 0000000..e4edce0 |
22 |
--- /dev/null |
23 |
+++ b/man/include/qsize.desc |
24 |
@@ -0,0 +1,3 @@ |
25 |
+\fIqsize\fR calculates the storage size taken by an installed package. |
26 |
+The reported sizes can be the recorded exact sizes of all files, or the |
27 |
+storage space they consume given the underlying filesystem. |
28 |
|
29 |
diff --git a/man/include/qsize.optdesc.yaml b/man/include/qsize.optdesc.yaml |
30 |
new file mode 100644 |
31 |
index 0000000..8dd58e4 |
32 |
--- /dev/null |
33 |
+++ b/man/include/qsize.optdesc.yaml |
34 |
@@ -0,0 +1,5 @@ |
35 |
+ignore: | |
36 |
+ Filter out entries matching \fI<arg>\fR, which is a regular |
37 |
+ expression, before calculating size. |
38 |
+verbose: Ignored for compatibility with other qapplets. |
39 |
+quiet: Ignored for compatibility with other qapplets. |
40 |
|
41 |
diff --git a/man/include/qtbz2.desc b/man/include/qtbz2.desc |
42 |
new file mode 100644 |
43 |
index 0000000..2ba37db |
44 |
--- /dev/null |
45 |
+++ b/man/include/qtbz2.desc |
46 |
@@ -0,0 +1,2 @@ |
47 |
+\fIqtbz2\fR joins and splits combined xpak+tarbz2 files. Gentoo binary |
48 |
+packages are such combined files. |
49 |
|
50 |
diff --git a/man/include/qtbz2.optdesc.yaml b/man/include/qtbz2.optdesc.yaml |
51 |
new file mode 100644 |
52 |
index 0000000..c1ebcd1 |
53 |
--- /dev/null |
54 |
+++ b/man/include/qtbz2.optdesc.yaml |
55 |
@@ -0,0 +1,2 @@ |
56 |
+verbose: Print some files and sizes while joining and splitting. |
57 |
+quiet: Ignored for compatibility with other qapplets. |
58 |
|
59 |
diff --git a/man/qtbz2.1 b/man/qtbz2.1 |
60 |
index b22c70c..94db0d8 100644 |
61 |
--- a/man/qtbz2.1 |
62 |
+++ b/man/qtbz2.1 |
63 |
@@ -1,53 +1,56 @@ |
64 |
-.TH qtbz2 "1" "Mar 2016" "Gentoo Foundation" "qtbz2" |
65 |
+.\" generated by mkman.py, please do NOT edit! |
66 |
+.TH qtbz2 "1" "Apr 2018" "Gentoo Foundation" "qtbz2" |
67 |
.SH NAME |
68 |
qtbz2 \- manipulate tbz2 packages |
69 |
.SH SYNOPSIS |
70 |
.B qtbz2 |
71 |
\fI[opts] <misc args>\fR |
72 |
.SH DESCRIPTION |
73 |
- |
74 |
+\fIqtbz2\fR joins and splits combined xpak+tarbz2 files. Gentoo binary |
75 |
+packages are such combined files. |
76 |
.SH OPTIONS |
77 |
.TP |
78 |
\fB\-d\fR \fI<arg>\fR, \fB\-\-dir\fR \fI<arg>\fR |
79 |
-Change to specified directory |
80 |
+Change to specified directory. |
81 |
.TP |
82 |
\fB\-j\fR, \fB\-\-join\fR |
83 |
-Join: <tar.bz2> <xpak> <tbz2> |
84 |
+Join: <tar.bz2> <xpak> <tbz2>. |
85 |
.TP |
86 |
\fB\-s\fR, \fB\-\-split\fR |
87 |
-Split a tbz2 into a tar.bz2 + xpak |
88 |
+Split a tbz2 into a tar.bz2 + xpak. |
89 |
.TP |
90 |
\fB\-t\fR, \fB\-\-tarbz2\fR |
91 |
-Just split the tar.bz2 |
92 |
+Just split the tar.bz2. |
93 |
.TP |
94 |
\fB\-x\fR, \fB\-\-xpak\fR |
95 |
-Just split the xpak |
96 |
+Just split the xpak. |
97 |
.TP |
98 |
\fB\-O\fR, \fB\-\-stdout\fR |
99 |
-Write files to stdout |
100 |
+Write files to stdout. |
101 |
.TP |
102 |
\fB\-\-root\fR \fI<arg>\fR |
103 |
-Set the ROOT env var |
104 |
+Set the ROOT env var. |
105 |
.TP |
106 |
\fB\-v\fR, \fB\-\-verbose\fR |
107 |
-Make a lot of noise |
108 |
+Print some files and sizes while joining and splitting. |
109 |
.TP |
110 |
\fB\-q\fR, \fB\-\-quiet\fR |
111 |
-Tighter output; suppress warnings |
112 |
+Ignored for compatibility with other qapplets. |
113 |
.TP |
114 |
\fB\-C\fR, \fB\-\-nocolor\fR |
115 |
-Don't output color |
116 |
+Don't output color. |
117 |
.TP |
118 |
\fB\-h\fR, \fB\-\-help\fR |
119 |
-Print this help and exit |
120 |
+Print this help and exit. |
121 |
.TP |
122 |
\fB\-V\fR, \fB\-\-version\fR |
123 |
-Print version and exit |
124 |
+Print version and exit. |
125 |
|
126 |
.SH "REPORTING BUGS" |
127 |
Please report bugs via http://bugs.gentoo.org/ |
128 |
.br |
129 |
-Product: Portage Development; Component: Tools |
130 |
+Product: Portage Development; Component: Tools, Assignee: |
131 |
+portage-utils@g.o |
132 |
.SH AUTHORS |
133 |
.nf |
134 |
Ned Ludd <solar@g.o> |