1 |
commit: 3b1cb130c9d20ef0d1190d7b7baf25a910765167 |
2 |
Author: Fabian Groffen <grobian <AT> gentoo <DOT> org> |
3 |
AuthorDate: Sun Apr 1 13:47:10 2018 +0000 |
4 |
Commit: Fabian Groffen <grobian <AT> gentoo <DOT> org> |
5 |
CommitDate: Sun Apr 1 13:47:10 2018 +0000 |
6 |
URL: https://gitweb.gentoo.org/proj/portage-utils.git/commit/?id=3b1cb130 |
7 |
|
8 |
man/qdepends: improve manpage |
9 |
|
10 |
Bug https://bugs.gentoo.org/645554 |
11 |
|
12 |
man/include/qdepends-05-examples.include | 17 +++++++ |
13 |
man/include/qdepends.desc | 10 +++-- |
14 |
man/include/qdepends.optdesc.yaml | 29 ++++++++++++ |
15 |
man/qdepends.1 | 77 ++++++++++++++++++++++++-------- |
16 |
4 files changed, 111 insertions(+), 22 deletions(-) |
17 |
|
18 |
diff --git a/man/include/qdepends-05-examples.include b/man/include/qdepends-05-examples.include |
19 |
index d4779ea..04fb92f 100644 |
20 |
--- a/man/include/qdepends-05-examples.include |
21 |
+++ b/man/include/qdepends-05-examples.include |
22 |
@@ -6,3 +6,20 @@ For finding out what a particular package depends on for building, you could do: |
23 |
.fi |
24 |
This tells us that we have \fIapp-editors/nano-2.3.2\fR installed and it depends |
25 |
on ncurses (among other things). |
26 |
+ |
27 |
+Searching for packages that actually have nano in their RDEPEND: |
28 |
+.nf |
29 |
+ $ \fIqdepends -rQ nano\fR |
30 |
+ virtual/editor-0 |
31 |
+.fi |
32 |
+Tells us that \fIvirtual/editor\fR depends on nano. However, if we |
33 |
+wanted to know in what way a package specifically depends on another |
34 |
+package, one can use \fB\-v\fR. |
35 |
+.nf |
36 |
+ $ \fIqdepends -vrQ logrotate\fR |
37 |
+ sys-apps/portage-2.3.18: >=app-admin/logrotate-3.8.0 |
38 |
+.fi |
39 |
+This way we can see there is a specific dependency expressed here. If |
40 |
+the above had used \fI<logrotate-3\fR, for example, no matches would be |
41 |
+returned. Not using any specifiers allows to reveal in what way a |
42 |
+dependency is expressed. |
43 |
|
44 |
diff --git a/man/include/qdepends.desc b/man/include/qdepends.desc |
45 |
index b9713d0..0143847 100644 |
46 |
--- a/man/include/qdepends.desc |
47 |
+++ b/man/include/qdepends.desc |
48 |
@@ -1,11 +1,15 @@ |
49 |
-The qdepends applet has a couple different modes. Normally it is geared towards |
50 |
+The |
51 |
+.I qdepends |
52 |
+applet has a couple different modes. Normally it is geared towards |
53 |
answering the queries "what does package X depend on" and "what packages depend |
54 |
on X". Both can further be classified into build, run, and post dependencies. |
55 |
|
56 |
By default, it will tell you the build time dependencies only (DEPEND). |
57 |
|
58 |
-Currently, qdepends will only query installed packages. There is no support for |
59 |
-querying packages not yet installed (the \fBequery\fR(1) tool can do that). |
60 |
+Currently, |
61 |
+.I qdepends |
62 |
+will only query installed packages. There is no support for |
63 |
+querying packages not yet installed (see \fBequery\fR(1) for that). |
64 |
|
65 |
If there is no answer to your query (i.e. you've asked for a package that is not |
66 |
installed, or a version that does not match), then you will get back no output. |
67 |
|
68 |
diff --git a/man/include/qdepends.optdesc.yaml b/man/include/qdepends.optdesc.yaml |
69 |
new file mode 100644 |
70 |
index 0000000..51b1cc7 |
71 |
--- /dev/null |
72 |
+++ b/man/include/qdepends.optdesc.yaml |
73 |
@@ -0,0 +1,29 @@ |
74 |
+all: | |
75 |
+ Show *DEPEND, alias for \fB\-drp\fR. |
76 |
+key: | |
77 |
+ Advanced option to allow querying the VDB. This option overrides |
78 |
+ \fB\-d\fR, \fB\-r\fR, \fB\-p\fR or \fB\-a\fR. \fI<arg>\fR can be |
79 |
+ any key from Portage's VDB, e.g.\ any file from |
80 |
+ var/db/pkg/<cat>/<pkg>/. |
81 |
+query: | |
82 |
+ Query reverse deps. This basically reverses the search to any |
83 |
+ package that references \fI<arg>\fR in DEPEND, RDEPEND or PDEPEND. |
84 |
+ This can be useful to find consumers of a given package, e.g.\ to |
85 |
+ search for packages that have \fIlogwatch\fR in their DEPEND. |
86 |
+name-only: | |
87 |
+ Only show category/package, instead of category/package-version. |
88 |
+format: | |
89 |
+ Pretty-print DEPEND declaration to be used in an ebuild. This |
90 |
+ option initiates a very different mode of operation. Instead of |
91 |
+ printing searching through packages, it constructs a multi-line |
92 |
+ statement in with shell syntax, to be used in an ebuild. Each |
93 |
+ argument is turned into a separate DEPEND variable declaration. You |
94 |
+ need to quote dependency strings in order for them to be printed as |
95 |
+ a single dependency declaration. When used with the \fB\-q\fR |
96 |
+ option, only the pretty-printed dependency declaration is printed, |
97 |
+ e.g.\ the DEPEND= part is skipped. |
98 |
+verbose: | |
99 |
+ When in reverse dep mode, print the package or packages that matched |
100 |
+ the query from the dependency line being searched. This includes |
101 |
+ specifiers and versions. |
102 |
+quiet: Suppress DEPEND= output for \fB\-f\fR. |
103 |
|
104 |
diff --git a/man/qdepends.1 b/man/qdepends.1 |
105 |
index a0cac5b..c51a02d 100644 |
106 |
--- a/man/qdepends.1 |
107 |
+++ b/man/qdepends.1 |
108 |
@@ -1,64 +1,85 @@ |
109 |
-.TH qdepends "1" "Mar 2016" "Gentoo Foundation" "qdepends" |
110 |
+.\" generated by mkman.py, please do NOT edit! |
111 |
+.TH qdepends "1" "Apr 2018" "Gentoo Foundation" "qdepends" |
112 |
.SH NAME |
113 |
qdepends \- show dependency info |
114 |
.SH SYNOPSIS |
115 |
.B qdepends |
116 |
\fI[opts] <pkgname>\fR |
117 |
.SH DESCRIPTION |
118 |
-The qdepends applet has a couple different modes. Normally it is geared towards |
119 |
+The |
120 |
+.I qdepends |
121 |
+applet has a couple different modes. Normally it is geared towards |
122 |
answering the queries "what does package X depend on" and "what packages depend |
123 |
on X". Both can further be classified into build, run, and post dependencies. |
124 |
|
125 |
By default, it will tell you the build time dependencies only (DEPEND). |
126 |
|
127 |
-Currently, qdepends will only query installed packages. There is no support for |
128 |
-querying packages not yet installed (the \fBequery\fR(1) tool can do that). |
129 |
+Currently, |
130 |
+.I qdepends |
131 |
+will only query installed packages. There is no support for |
132 |
+querying packages not yet installed (see \fBequery\fR(1) for that). |
133 |
|
134 |
If there is no answer to your query (i.e. you've asked for a package that is not |
135 |
installed, or a version that does not match), then you will get back no output. |
136 |
.SH OPTIONS |
137 |
.TP |
138 |
\fB\-d\fR, \fB\-\-depend\fR |
139 |
-Show DEPEND info (default) |
140 |
+Show DEPEND info (default). |
141 |
.TP |
142 |
\fB\-r\fR, \fB\-\-rdepend\fR |
143 |
-Show RDEPEND info |
144 |
+Show RDEPEND info. |
145 |
.TP |
146 |
\fB\-p\fR, \fB\-\-pdepend\fR |
147 |
-Show PDEPEND info |
148 |
+Show PDEPEND info. |
149 |
.TP |
150 |
\fB\-k\fR \fI<arg>\fR, \fB\-\-key\fR \fI<arg>\fR |
151 |
-User defined vdb key |
152 |
+Advanced option to allow querying the VDB. This option overrides |
153 |
+\fB\-d\fR, \fB\-r\fR, \fB\-p\fR or \fB\-a\fR. \fI<arg>\fR can be |
154 |
+any key from Portage's VDB, e.g.\ any file from |
155 |
+var/db/pkg/<cat>/<pkg>/. |
156 |
.TP |
157 |
\fB\-Q\fR \fI<arg>\fR, \fB\-\-query\fR \fI<arg>\fR |
158 |
-Query reverse deps |
159 |
+Query reverse deps. This basically reverses the search to any |
160 |
+package that references \fI<arg>\fR in DEPEND, RDEPEND or PDEPEND. |
161 |
+This can be useful to find consumers of a given package, e.g.\ to |
162 |
+search for packages that have \fIlogwatch\fR in their DEPEND. |
163 |
.TP |
164 |
\fB\-N\fR, \fB\-\-name\-only\fR |
165 |
-Only show package name |
166 |
+Only show category/package, instead of category/package-version. |
167 |
.TP |
168 |
\fB\-a\fR, \fB\-\-all\fR |
169 |
-Show all DEPEND info |
170 |
+Show *DEPEND, alias for \fB\-drp\fR. |
171 |
.TP |
172 |
\fB\-f\fR, \fB\-\-format\fR |
173 |
-Pretty format specified depend strings |
174 |
+Pretty-print DEPEND declaration to be used in an ebuild. This |
175 |
+option initiates a very different mode of operation. Instead of |
176 |
+printing searching through packages, it constructs a multi-line |
177 |
+statement in with shell syntax, to be used in an ebuild. Each |
178 |
+argument is turned into a separate DEPEND variable declaration. You |
179 |
+need to quote dependency strings in order for them to be printed as |
180 |
+a single dependency declaration. When used with the \fB\-q\fR |
181 |
+option, only the pretty-printed dependency declaration is printed, |
182 |
+e.g.\ the DEPEND= part is skipped. |
183 |
.TP |
184 |
\fB\-\-root\fR \fI<arg>\fR |
185 |
-Set the ROOT env var |
186 |
+Set the ROOT env var. |
187 |
.TP |
188 |
\fB\-v\fR, \fB\-\-verbose\fR |
189 |
-Make a lot of noise |
190 |
+When in reverse dep mode, print the package or packages that matched |
191 |
+the query from the dependency line being searched. This includes |
192 |
+specifiers and versions. |
193 |
.TP |
194 |
\fB\-q\fR, \fB\-\-quiet\fR |
195 |
-Tighter output; suppress warnings |
196 |
+Suppress DEPEND= output for \fB\-f\fR. |
197 |
.TP |
198 |
\fB\-C\fR, \fB\-\-nocolor\fR |
199 |
-Don't output color |
200 |
+Don't output color. |
201 |
.TP |
202 |
\fB\-h\fR, \fB\-\-help\fR |
203 |
-Print this help and exit |
204 |
+Print this help and exit. |
205 |
.TP |
206 |
\fB\-V\fR, \fB\-\-version\fR |
207 |
-Print version and exit |
208 |
+Print version and exit. |
209 |
.SH "EXAMPLES" |
210 |
For finding out what a particular package depends on for building, you could do: |
211 |
.nf |
212 |
@@ -67,10 +88,28 @@ For finding out what a particular package depends on for building, you could do: |
213 |
.fi |
214 |
This tells us that we have \fIapp-editors/nano-2.3.2\fR installed and it depends |
215 |
on ncurses (among other things). |
216 |
+ |
217 |
+Searching for packages that actually have nano in their RDEPEND: |
218 |
+.nf |
219 |
+ $ \fIqdepends -rQ nano\fR |
220 |
+ virtual/editor-0 |
221 |
+.fi |
222 |
+Tells us that \fIvirtual/editor\fR depends on nano. However, if we |
223 |
+wanted to know in what way a package specifically depends on another |
224 |
+package, one can use \fB\-v\fR. |
225 |
+.nf |
226 |
+ $ \fIqdepends -vrQ logrotate\fR |
227 |
+ sys-apps/portage-2.3.18: >=app-admin/logrotate-3.8.0 |
228 |
+.fi |
229 |
+This way we can see there is a specific dependency expressed here. If |
230 |
+the above had used \fI<logrotate-3\fR, for example, no matches would be |
231 |
+returned. Not using any specifiers allows to reveal in what way a |
232 |
+dependency is expressed. |
233 |
.SH "REPORTING BUGS" |
234 |
Please report bugs via http://bugs.gentoo.org/ |
235 |
.br |
236 |
-Product: Portage Development; Component: Tools |
237 |
+Product: Portage Development; Component: Tools, Assignee: |
238 |
+portage-utils@g.o |
239 |
.SH AUTHORS |
240 |
.nf |
241 |
Ned Ludd <solar@g.o> |