/[gentoo]/xml/htdocs/doc/en/gentoolkit.xml
Gentoo

Diff of /xml/htdocs/doc/en/gentoolkit.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.35 Revision 1.36
1<?xml version="1.0" encoding="UTF-8"?> 1<?xml version="1.0" encoding="UTF-8"?>
2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoolkit.xml,v 1.35 2011/08/15 19:29:48 swift Exp $ --> 2<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoolkit.xml,v 1.36 2011/08/15 19:30:36 swift Exp $ -->
3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> 3<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
4 4
5<guide> 5<guide>
6<title>Gentoolkit</title> 6<title>Gentoolkit</title>
7 7
8<author title="Author"> 8<author title="Author">
9 <mail link="mbutcher@aleph-null.tv">Matt Butcher</mail> 9 <mail link="mbutcher@aleph-null.tv">Matt Butcher</mail>
10</author> 10</author>
11<author title="Editor"> 11<author title="Editor">
12 <!-- zhen@gentoo.org -->John P. Davis 12 <!-- zhen@gentoo.org -->John P. Davis
13</author> 13</author>
14<author title="Editor"> 14<author title="Editor">
15 <mail link="erwin@gentoo.org">Erwin</mail> 15 <mail link="erwin@gentoo.org">Erwin</mail>
16</author> 16</author>
17<author title="Editor"> 17<author title="Editor">
29<author title="Editor"> 29<author title="Editor">
30 <mail link="nightmorph@gentoo.org">Joshua Saddler</mail> 30 <mail link="nightmorph@gentoo.org">Joshua Saddler</mail>
31</author> 31</author>
32<author title="Editor"> 32<author title="Editor">
33 <mail link="douglasjanderson@gmail.com">Douglas Anderson</mail> 33 <mail link="douglasjanderson@gmail.com">Douglas Anderson</mail>
34</author> 34</author>
35 35
36<abstract> 36<abstract>
37Gentoolkit is a suite of tools to ease the administration of a Gentoo system. 37Gentoolkit is a suite of tools to ease the administration of a Gentoo system.
38This document covers the basics of some of the tools present in Gentoolkit. 38This document covers the basics of some of the tools present in Gentoolkit.
39</abstract> 39</abstract>
40 40
41<!-- Licensed under GFDL --> 41<!-- Licensed under GFDL -->
42 42
43<version>4</version> 43<version>4</version>
44<date>2011-08-15</date> 44<date>2011-08-16</date>
45 45
46<chapter> 46<chapter>
47<title>Introduction</title> 47<title>Introduction</title>
48<section> 48<section>
49<title>What is Gentoolkit?</title> 49<title>What is Gentoolkit?</title>
50<body> 50<body>
51 51
52<p> 52<p>
53Gentoo is a unique distribution and presents some complexities that simply 53Gentoo is a unique distribution and presents some complexities that simply
54don't exist for other distributions. As Gentoo developers and contributors 54don't exist for other distributions. As Gentoo developers and contributors
55discovered some of these complexities, they also wrote tools to help users and 55discovered some of these complexities, they also wrote tools to help users and
56administrators work around them. Many of these tools have been contributed to 56administrators work around them. Many of these tools have been contributed to
57the Gentoo project and are included in the package 57the Gentoo project and are included in the package
58<c>app-portage/gentoolkit</c>. 58<c>app-portage/gentoolkit</c>.
59</p> 59</p>
105<path>/usr/share/doc/gentoolkit-[version]/[program-name]/</path>. 105<path>/usr/share/doc/gentoolkit-[version]/[program-name]/</path>.
106</p> 106</p>
107 107
108</body> 108</body>
109</section> 109</section>
110</chapter> 110</chapter>
111 111
112<chapter> 112<chapter>
113<title>equery</title> 113<title>equery</title>
114<section> 114<section>
115<title>Introduction</title> 115<title>Introduction</title>
116<body> 116<body>
117 117
118<p> 118<p>
119<c>equery</c> is a tool that displays useful information about the packages on 119<c>equery</c> is a tool that displays useful information about the packages on
120your system. <c>equery</c> is based on a system of modules. 120your system. <c>equery</c> is based on a system of modules.
121Every module has a shorthand name. For example, <c>equery l gcc</c> is the same 121Every module has a shorthand name. For example, <c>equery l gcc</c> is the same
122as <c>equery list gcc</c>. <c>equery --help</c> explains global options 122as <c>equery list gcc</c>. <c>equery --help</c> explains global options
123and lists all available modules and their shorthand names. 123and lists all available modules and their shorthand names.
124<c>equery --help module</c> will display the help screen for a specific 124<c>equery --help module</c> will display the help screen for a specific
125module. Lastly, <c>man equery</c> provides a detailed explanation of all 125module. Lastly, <c>man equery</c> provides a detailed explanation of all
126available modules and options, and provides useful examples. 126available modules and options, and provides useful examples.
127</p> 127</p>
128 128
129<p> 129<p>
130Below is a list of features that work over the majority of modules. 130Below is a list of features that work over the majority of modules.
131</p> 131</p>
132 132
133<pre caption="Examples of Acceptable Input"> 133<pre caption="Examples of Acceptable Input">
134<comment>(Many modules require a package argument. equery accepts all emerge-like input):</comment> 134<comment>(Many modules require a package argument. equery accepts all emerge-like input):</comment>
135$ <i>equery --quiet list gcc</i> # <comment>package</comment> 135$ <i>equery --quiet list gcc</i> # <comment>package</comment>
136sys-devel/gcc-4.3.2-r3 136sys-devel/gcc-4.3.2-r3
137$ <i>equery --quiet list sys-devel/gcc</i> # <comment>category/package</comment> 137$ <i>equery --quiet list sys-devel/gcc</i> # <comment>category/package</comment>
138sys-devel/gcc-4.3.2-r3 138sys-devel/gcc-4.3.2-r3
143$ <i>equery check zilla</i> 143$ <i>equery check zilla</i>
144!!! No package found matching zilla 144!!! No package found matching zilla
145 145
146<comment>(Unlike emerge, equery can accept shell-like globbing in the category and/or package name):</comment> 146<comment>(Unlike emerge, equery can accept shell-like globbing in the category and/or package name):</comment>
147$ <i>equery check '*zilla*'</i> 147$ <i>equery check '*zilla*'</i>
148 * Checking www-client/mozilla-firefox-3.0.14 ... 148 * Checking www-client/mozilla-firefox-3.0.14 ...
149 90 out of 90 files passed 149 90 out of 90 files passed
150$ <i>equery check www-c*/*</i> 150$ <i>equery check www-c*/*</i>
151 * Checking www-client/links-2.2 ... 151 * Checking www-client/links-2.2 ...
152 30 out of 30 files passed 152 30 out of 30 files passed
153 * Checking www-client/mozilla-firefox-3.0.14 ... 153 * Checking www-client/mozilla-firefox-3.0.14 ...
154 90 out of 90 files passed 154 90 out of 90 files passed
155 155
156<comment>(Most equery modules take multiple input):</comment> 156<comment>(Most equery modules take multiple input):</comment>
157$ <i>equery hasuse sse sse2</i> 157$ <i>equery hasuse sse sse2</i>
158 * Searching for USE flag sse ... 158 * Searching for USE flag sse ...
159[IP-] [ ] media-libs/flac-1.2.1-r3 (0) 159[IP-] [ ] media-libs/flac-1.2.1-r3 (0)
160[IP-] [ ] media-libs/speex-1.2_beta3_p2 (0) 160[IP-] [ ] media-libs/speex-1.2_beta3_p2 (0)
161 161
162 * Searching for USE flag sse2 ... 162 * Searching for USE flag sse2 ...
163[IP-] [ ] dev-libs/openssl-0.9.8k (0) 163[IP-] [ ] dev-libs/openssl-0.9.8k (0)
164[IP-] [ ] x11-libs/pixman-0.16.0 (0) 164[IP-] [ ] x11-libs/pixman-0.16.0 (0)
165 165
166<comment>(A few modules also allow full regular expressions):</comment> 166<comment>(A few modules also allow full regular expressions):</comment>
167$ <i>equery -q list --portage-tree --full-regex '[kr]?flickr.*'</i> 167$ <i>equery -q list --portage-tree --full-regex '[kr]?flickr.*'</i>
168dev-dotnet/flickrnet-bin-2.2 168dev-dotnet/flickrnet-bin-2.2
169dev-ruby/flickr-1.0.2-r1 169dev-ruby/flickr-1.0.2-r1
170dev-ruby/flickr-1.0.2-r2 170dev-ruby/flickr-1.0.2-r2
171dev-ruby/rflickr-20060201 171dev-ruby/rflickr-20060201
172media-gfx/kflickr-0.6 172media-gfx/kflickr-0.6
173[...] 173[...]
174</pre> 174</pre>
175 175
176<note> 176<note>
177Globbing support replaced a number of older options in <c>equery</c>. 177Globbing support replaced a number of older options in <c>equery</c>.
178For example, to act on all packages in a certain set, use <c>'*'</c>. 178For example, to act on all packages in a certain set, use <c>'*'</c>.
179To act on all packages in a category, use <c>'category-name/*'</c>. 179To act on all packages in a category, use <c>'category-name/*'</c>.
180</note> 180</note>
181 181
182<warn> 182<warn>
183Don't forget to quote input when using special shell characters 183Don't forget to quote input when using special shell characters
184like asterisks or greater than/less than signs. 184like asterisks or greater than/less than signs.
185</warn> 185</warn>
186 186
187<p> 187<p>
188The next few sections in this document give a quick introduction to the 188The next few sections in this document give a quick introduction to the
189different <c>equery</c> modules. 189different <c>equery</c> modules.
190</p> 190</p>
191 191
192</body> 192</body>
193</section> 193</section>
194<section> 194<section>
195<title>Finding the Package That a File Came From with belongs (b)</title> 195<title>Finding the Package That a File Came From with belongs (b)</title>
196<body> 196<body>
197 197
198<pre caption="Finding the Package that Installed a Given File"> 198<pre caption="Finding the Package that Installed a Given File">
199$ <i>equery belongs -e /usr/bin/glxgears</i> 199$ <i>equery belongs -e /usr/bin/glxgears</i>
200 * Searching for /usr/bin/glxgears ... 200 * Searching for /usr/bin/glxgears ...
201 x11-apps/mesa-progs-7.5.1 (/usr/bin/glxgears) 201 x11-apps/mesa-progs-7.5.1 (/usr/bin/glxgears)
202</pre> 202</pre>
203 203
204<p> 204<p>
205<c>belongs</c> can search for files matching a regular expression with the 205<c>belongs</c> can search for files matching a regular expression with the
206<c>-f</c> option. The <c>-e</c> option stops searching after it finds a match. 206<c>-f</c> option. The <c>-e</c> option stops searching after it finds a match.
207Since no file on your system should be owned by two packages, this is a safe 207Since no file on your system should be owned by two packages, this is a safe
208optimization. 208optimization.
209</p> 209</p>
210 210
211</body> 211</body>
212</section> 212</section>
213<section> 213<section>
214<title>Viewing ChangeLog Entries with changes (c)</title> 214<title>Viewing ChangeLog Entries with changes (c)</title>
215<body> 215<body>
216 216
217<p> 217<p>
218<c>changes</c> lets you view ChangeLog entries for a package version or range 218<c>changes</c> lets you view ChangeLog entries for a package version or range
219of versions. Imagine after an <c>emerge --sync</c>, you 219of versions. Imagine after an <c>emerge --sync</c>, you
220notice Portage is going to be upgraded and want to check what has changed: 220notice Portage is going to be upgraded and want to check what has changed:
221</p> 221</p>
222 222
223<pre caption="Viewing Gentoo ChangeLog Entries"> 223<pre caption="Viewing Gentoo ChangeLog Entries">
224<comment>(Show the latest installable version's entry):</comment> 224<comment>(Show the latest installable version's entry):</comment>
225$ <i>equery changes portage</i> 225$ <i>equery changes portage</i>
226*portage-2.1.6.13 (03 May 2009) 226*portage-2.1.6.13 (03 May 2009)
227 227
228 03 May 2009; Zac Medico &lt;zmedico@gentoo.org&gt; +portage-2.1.6.13.ebuild: 228 03 May 2009; Zac Medico &lt;zmedico@gentoo.org&gt; +portage-2.1.6.13.ebuild:
229 2.1.6.13 bump. This fixes bug #268398 (document econf automatic die) 229 2.1.6.13 bump. This fixes bug #268398 (document econf automatic die)
230 and bug #267104 (handle insufficient space interaction with userfetch). 230 and bug #267104 (handle insufficient space interaction with userfetch).
231 Bug #268228 tracks all bugs fixed since 2.1.6.11. 231 Bug #268228 tracks all bugs fixed since 2.1.6.11.
232</pre> 232</pre>
233 233
234</body> 234</body>
272dev-python/gnome-python-desktop-base-2.24.1 (>=dev-python/pygtk-2.10.3) 272dev-python/gnome-python-desktop-base-2.24.1 (>=dev-python/pygtk-2.10.3)
273[...] 273[...]
274</pre> 274</pre>
275 275
276</body> 276</body>
277</section> 277</section>
278<section> 278<section>
279<title>Getting Dependency Graphs with depgraph (g)</title> 279<title>Getting Dependency Graphs with depgraph (g)</title>
280<body> 280<body>
281 281
282<p> 282<p>
283<c>depgraph</c> is the opposite of <c>depends</c>. You pass it a package, and 283<c>depgraph</c> is the opposite of <c>depends</c>. You pass it a package, and
284it will find the packages <e>it</e> depends on (not that depend on it). 284it will find the packages <e>it</e> depends on (not that depend on it).
285When it finds a dependency, it will recursively search for all of 285When it finds a dependency, it will recursively search for all of
286<e>that</e> package's dependencies. Control how deep the tree gets with 286<e>that</e> package's dependencies. Control how deep the tree gets with
287the <c>--depth</c> option. 287the <c>--depth</c> option.
288</p> 288</p>
289 289
290<pre caption="Viewing Dependency Graph for mozilla-firefox"> 290<pre caption="Viewing Dependency Graph for mozilla-firefox">
291$ <i>equery depgraph mozilla-firefox</i> 291$ <i>equery depgraph mozilla-firefox</i>
292 * Searching for mozilla-firefox ... 292 * Searching for mozilla-firefox ...
293 * dependency graph for www-client/mozilla-firefox-2.0.0.19: 293 * dependency graph for www-client/mozilla-firefox-2.0.0.19:
294`-- www-client/mozilla-firefox-2.0.0.19 294`-- www-client/mozilla-firefox-2.0.0.19
295 `-- virtual/jre-1.6.0 (virtual/jre) [java] 295 `-- virtual/jre-1.6.0 (virtual/jre) [java]
296 `-- virtual/jdk-1.6.0 (virtual/jdk-1.6.0*) 296 `-- virtual/jdk-1.6.0 (virtual/jdk-1.6.0*)
297 `-- dev-java/icedtea6-bin (unable to resolve: package masked or removed) 297 `-- dev-java/icedtea6-bin (unable to resolve: package masked or removed)
298 `-- dev-java/sun-jdk-1.6.0.15 298 `-- dev-java/sun-jdk-1.6.0.15
299 `-- dev-java/java-sdk-docs-1.6.0.10 [doc] 299 `-- dev-java/java-sdk-docs-1.6.0.10 [doc]
300 `-- app-arch/unzip-6.0-r1 300 `-- app-arch/unzip-6.0-r1
301 `-- app-arch/bzip2-1.0.5-r1 [bzip2] 301 `-- app-arch/bzip2-1.0.5-r1 [bzip2]
302 `-- sys-libs/glibc-2.9_p20081201-r2 302 `-- sys-libs/glibc-2.9_p20081201-r2
361 + depends.py 361 + depends.py
362 + depgraph.py 362 + depgraph.py
363 + files.py 363 + files.py
364[...] 364[...]
365</pre> 365</pre>
366 366
367</body> 367</body>
368</section> 368</section>
369<section> 369<section>
370<title>Looking for Packages that Have a Specific USE Flag with hasuse (h)</title> 370<title>Looking for Packages that Have a Specific USE Flag with hasuse (h)</title>
371<body> 371<body>
372 372
373<p> 373<p>
374You can use <c>hasuse</c> to find out which packages have a given USE flag. 374You can use <c>hasuse</c> to find out which packages have a given USE flag.
375<c>hasuse</c> won't tell you if the flag is enabled, only if the ebuild lists 375<c>hasuse</c> won't tell you if the flag is enabled, only if the ebuild lists
376it as an option. See the EXAMPLES section of <c>hasuse</c> in the 376it as an option. See the EXAMPLES section of <c>hasuse</c> in the
377<c>equery</c> man page for more tip on getting that information. 377<c>equery</c> man page for more tip on getting that information.
378</p> 378</p>
379 379
380<pre caption="Searching For Installed Packages that Use the qt3 or qt4 USE Flags"> 380<pre caption="Searching For Installed Packages that Use the qt3 or qt4 USE Flags">
381$ <i>equery hasuse qt3 qt4</i> 381$ <i>equery hasuse qt3 qt4</i>
382 * Searching for USE flag qt3 ... 382 * Searching for USE flag qt3 ...
383[IP-] [ ] app-crypt/pinentry-0.7.5 (0) 383[IP-] [ ] app-crypt/pinentry-0.7.5 (0)
384[IP-] [ ] net-dns/avahi-0.6.24-r2 (0) 384[IP-] [ ] net-dns/avahi-0.6.24-r2 (0)
385[IP-] [ ] net-wireless/wpa_supplicant-0.6.9 (0) 385[IP-] [ ] net-wireless/wpa_supplicant-0.6.9 (0)
386 386
387 * Searching for USE flag qt4 ... 387 * Searching for USE flag qt4 ...
388[IP-] [ ] net-dns/avahi-0.6.24-r2 (0) 388[IP-] [ ] net-dns/avahi-0.6.24-r2 (0)
389[IP-] [ ] net-wireless/wpa_supplicant-0.6.9 (0) 389[IP-] [ ] net-wireless/wpa_supplicant-0.6.9 (0)
390</pre> 390</pre>
391 391
392</body> 392</body>
393</section> 393</section>
394<section> 394<section>
395<title>Listing Packages with list (l)</title> 395<title>Listing Packages with list (l)</title>
396<body> 396<body>
397 397
398<p> 398<p>
399<c>list</c> is a simple, yet powerful module to list packages that are installed, 399<c>list</c> is a simple, yet powerful module to list packages that are
400in the Portage tree or in an overlay. 400installed, in the Portage tree or in an overlay.
401</p> 401</p>
402 402
403<pre caption="Listing Installed Packages with list"> 403<pre caption="Listing Installed Packages with list">
404$ <i>equery list '*'</i> 404$ <i>equery list '*'</i>
405 * Searching for * ... 405 * Searching for * ...
406[IP-] [ ] app-admin/eselect-1.2.3 (0) 406[IP-] [ ] app-admin/eselect-1.2.3 (0)
407[IP-] [ ] app-admin/eselect-ctags-1.10 (0) 407[IP-] [ ] app-admin/eselect-ctags-1.10 (0)
408[IP-] [ ] app-admin/eselect-esd-20060719 (0) 408[IP-] [ ] app-admin/eselect-esd-20060719 (0)
409[IP-] [ ] app-admin/eselect-fontconfig-1.0 (0) 409[IP-] [ ] app-admin/eselect-fontconfig-1.0 (0)
410[IP-] [ ] app-admin/eselect-opengl-1.0.8-r1 (0) 410[IP-] [ ] app-admin/eselect-opengl-1.0.8-r1 (0)
411[IP-] [ ] app-admin/eselect-python-20090824 (0) 411[IP-] [ ] app-admin/eselect-python-20090824 (0)
412[IP-] [ ] app-admin/eselect-ruby-20081227 (0) 412[IP-] [ ] app-admin/eselect-ruby-20081227 (0)
413[IP-] [ ] app-admin/eselect-vi-1.1.5 (0) 413[IP-] [ ] app-admin/eselect-vi-1.1.5 (0)
414[IP-] [ ] app-admin/perl-cleaner-1.05 (0) 414[IP-] [ ] app-admin/perl-cleaner-1.05 (0)
415[IP-] [ ] app-admin/pessulus-2.24.0 (0) 415[IP-] [ ] app-admin/pessulus-2.24.0 (0)
416[IP-] [ ] app-admin/python-updater-0.7 (0) 416[IP-] [ ] app-admin/python-updater-0.7 (0)
417[IP-] [ ] app-admin/sudo-1.7.2_p1 (0) 417[IP-] [ ] app-admin/sudo-1.7.2_p1 (0)
418[...] 418[...]
419</pre> 419</pre>
420 420
421<p> 421<p>
422The standard query will search installed packages for the given package name. 422The standard query will search installed packages for the given package name.
423Passing in '*' displays all packages in the set. In the leftmost field, we 423Passing in '*' displays all packages in the set. In the leftmost field, we
424see that all the above packages are <c>I</c>nstalled and from the <c>P</c>ortage 424see that all the above packages are <c>I</c>nstalled and from the <c>P</c>ortage
425tree. They're not masked (the second field is blank), and they're all installed 425tree. They're not masked (the second field is blank), and they're all installed
426in the default slot (0). 426in the default slot (0).
427</p> 427</p>
428 428
429<p> 429<p>
430This time we are going to use local options to look for packages in the 430This time we are going to use local options to look for packages in the
431Portage tree and overlays. 431Portage tree and overlays.
432</p> 432</p>
433 433
434<pre caption="Using Local Options with list"> 434<pre caption="Using Local Options with list">
435$ <i>equery list -po vim</i> 435$ <i>equery list -po vim</i>
436 * Searching for vim ... 436 * Searching for vim ...
437[-P-] [ ] app-editors/vim-7.0.235 (0) 437[-P-] [ ] app-editors/vim-7.0.235 (0)
438[-P-] [ ~] app-editors/vim-7.0.243 (0) 438[-P-] [ ~] app-editors/vim-7.0.243 (0)
439[-P-] [ ] app-editors/vim-7.1.123 (0) 439[-P-] [ ] app-editors/vim-7.1.123 (0)
440[-P-] [ ~] app-editors/vim-7.1.330 (0) 440[-P-] [ ~] app-editors/vim-7.1.330 (0)
441[-P-] [ ] app-editors/vim-7.2 (0) 441[-P-] [ ] app-editors/vim-7.2 (0)
442[-P-] [ ~] app-editors/vim-7.2.108 (0) 442[-P-] [ ~] app-editors/vim-7.2.108 (0)
443[IP-] [ ] app-editors/vim-7.2.182 (0) 443[IP-] [ ] app-editors/vim-7.2.182 (0)
444[-P-] [ ~] app-editors/vim-7.2.238 (0) 444[-P-] [ ~] app-editors/vim-7.2.238 (0)
445[-P-] [ ~] app-editors/vim-7.2.264 (0) 445[-P-] [ ~] app-editors/vim-7.2.264 (0)
446</pre> 446</pre>
447 447
448<p> 448<p>
449In this example you can see version 7.2.182 is installed and there are no 449In this example you can see version 7.2.182 is installed and there are no
450versions available from an overlay. You can see which versions are keyword 450versions available from an overlay. You can see which versions are keyword
451masked by the <c>~</c> in the second field. 451masked by the <c>~</c> in the second field.
452</p> 452</p>
453 453
454</body> 454</body>
455</section> 455</section>
456<section> 456<section>
457<title>Viewing Package Metadata with meta (m)</title> 457<title>Viewing Package Metadata with meta (m)</title>
458<body> 458<body>
459 459
460<p> 460<p>
461Each package in the Portage tree provides at least some metadata about 461Each package in the Portage tree provides at least some metadata about
462its maintainer, herd, etc. Read about <uri 462its maintainer, herd, etc. Read about <uri
463link="http://www.gentoo.org/proj/en/devrel/handbook/handbook.xml?part=2&amp;chap=4">Gentoo 463link="http://www.gentoo.org/proj/en/devrel/handbook/handbook.xml?part=2&amp;chap=4">
464Metadata</uri>. The amount of useful information depends on how much package 464Gentoo Metadata</uri>. The amount of useful information depends on how much
465maintainers decide to provide. With no options, <c>meta</c> returns some basic 465package maintainers decide to provide. With no options, <c>meta</c> returns
466useful information. 466some basic useful information.
467</p> 467</p>
468 468
469<pre caption="Getting Package Metadata with meta"> 469<pre caption="Getting Package Metadata with meta">
470$ <i>equery meta gnucash</i> 470$ <i>equery meta gnucash</i>
471 * app-office/gnucash [gentoo] 471 * app-office/gnucash [gentoo]
472 Herd: gnome-office (gnome-office@gentoo.org) 472 Herd: gnome-office (gnome-office@gentoo.org)
473 Maintainer: tove@gentoo.org (Torsten Veller) 473 Maintainer: tove@gentoo.org (Torsten Veller)
474 Upstream: None specified 474 Upstream: None specified
475 Location: /usr/portage/app-office/gnucash 475 Location: /usr/portage/app-office/gnucash
476 Keywords: 2.2.9-r1:0: alpha amd64 ppc sparc x86 476 Keywords: 2.2.9-r1:0: alpha amd64 ppc sparc x86
477 Keywords: 2.2.9-r2:0: 477 Keywords: 2.2.9-r2:0:
478 Keywords: 2.3.8:0: 478 Keywords: 2.3.8:0:
479 Keywords: 2.3.10:0: ~alpha ~amd64 ~ppc ~sparc ~x86 479 Keywords: 2.3.10:0: ~alpha ~amd64 ~ppc ~sparc ~x86
480</pre> 480</pre>
481 481
482<p> 482<p>
483When the maintainer provides extra information, it can be very useful: 483When the maintainer provides extra information, it can be very useful:
484</p> 484</p>
485 485
486<pre caption="Getting Long Package Descriptions with meta"> 486<pre caption="Getting Long Package Descriptions with meta">
487$ <i>equery meta --description emacs</i> 487$ <i>equery meta --description emacs</i>
488 * app-editors/emacs 488 * app-editors/emacs
489 GNU Emacs is an extensible, customizable text editor - and more. At its core 489 GNU Emacs is an extensible, customizable text editor - and more. At its core
490 is an interpreter for Emacs Lisp, a dialect of the Lisp programming language 490 is an interpreter for Emacs Lisp, a dialect of the Lisp programming language
491 with extensions to support text editing. The features of GNU Emacs include: 491 with extensions to support text editing. The features of GNU Emacs include:
492 * Content-sensitive editing modes, including syntax coloring, for a wide 492 * Content-sensitive editing modes, including syntax coloring, for a wide
493 variety of file types including plain text, source code, and HTML. 493 variety of file types including plain text, source code, and HTML.
587 587
588<p> 588<p>
589<c>which</c> is a simple script to help you quickly find the file path to an 589<c>which</c> is a simple script to help you quickly find the file path to an
590ebuild. If you pass an unversioned package name, <c>which</c> will return the 590ebuild. If you pass an unversioned package name, <c>which</c> will return the
591path to the newest installable ebuild version, in other words, the ebuild 591path to the newest installable ebuild version, in other words, the ebuild
592Portage would use if you typed <c>emerge package</c>. Pass in a versioned 592Portage would use if you typed <c>emerge package</c>. Pass in a versioned
593package to get the path to that ebuild. 593package to get the path to that ebuild.
594</p> 594</p>
595 595
596<pre caption="Displaying the Latest Installable Ebuild Path"> 596<pre caption="Displaying the Latest Installable Ebuild Path">
597$ <i>equery which gnome</i> 597$ <i>equery which gnome</i>
598/usr/portage/gnome-base/gnome/gnome-2.26.3.ebuild 598/usr/portage/gnome-base/gnome/gnome-2.26.3.ebuild
599</pre> 599</pre>
600 600
601<p> 601<p>
602Lastly, if none of the above features of <c>equery</c> have answered your 602Lastly, if none of the above features of <c>equery</c> have answered your
603question, try using <c>which</c> to manually search an ebuild with programs 603question, try using <c>which</c> to manually search an ebuild with programs
604like <c>cat</c>, <c>less</c> or <c>grep</c>: 604like <c>cat</c>, <c>less</c> or <c>grep</c>:
605</p> 605</p>
606 606
607<pre caption="Other Useful Ways to Use which"> 607<pre caption="Other Useful Ways to Use which">
608$ <i>grep HOMEPAGE $(equery which gentoolkit)</i> 608$ <i>grep HOMEPAGE $(equery which gentoolkit)</i>
609HOMEPAGE="http://www.gentoo.org/proj/en/portage/tools/index.xml" 609HOMEPAGE="http://www.gentoo.org/proj/en/portage/tools/index.xml"
610</pre> 610</pre>
611 611
612<warn> 612<warn>
613Be aware that equery currently changes the format of the output if it is sent 613Be aware that <c>equery</c> currently changes the format of the output if it
614through a pipe. The piped format is intended to be easier to parse by tools, but 614is sent through a pipe. The piped format is intended to be easier to parse by
615you can also turn it off by adding the <c>--no-pipe</c> option. If you write 615tools, but you can also turn it off by adding the <c>--no-pipe</c> option. If
616scripts that employ equery, you should be aware of this. 616you write scripts that employ <c>equery</c>, you should be aware of this.
617</warn> 617</warn>
618 618
619</body> 619</body>
620</section> 620</section>
621</chapter> 621</chapter>
622 622
623<chapter> 623<chapter>
624<title>euse</title> 624<title>euse</title>
625<section> 625<section>
626<title>Introduction</title> 626<title>Introduction</title>
627<body> 627<body>
628 628
629<p> 629<p>
630<c>euse</c> is a tool to see, set and unset USE flags at various places. For 630<c>euse</c> is a tool to see, set and unset USE flags at various places. For
631more information on USE flags, please refer to the <uri 631more information on USE flags, please refer to the <uri

Legend:
Removed from v.1.35  
changed lines
  Added in v.1.36

  ViewVC Help
Powered by ViewVC 1.1.20