Index: gentoolkit.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoolkit.xml,v retrieving revision 1.34 diff -u -B -u -r1.34 gentoolkit.xml --- gentoolkit.xml 14 Aug 2011 17:02:52 -0000 1.34 +++ gentoolkit.xml 15 Aug 2011 17:27:05 -0000 @@ -117,10 +117,10 @@

equery is a tool that displays useful information about the packages on -your system. equery is based on a system of modules. +your system. equery is based on a system of modules. Every module has a shorthand name. For example, equery l gcc is the same as equery list gcc. equery --help explains global options -and lists all available modules and their shorthand names. +and lists all available modules and their shorthand names. equery --help module will display the help screen for a specific module. Lastly, man equery provides a detailed explanation of all available modules and options, and provides useful examples. @@ -155,11 +155,11 @@ (Most equery modules take multiple input): $ equery hasuse sse sse2 - * Searching for USE flag sse ... + * Searching for USE flag sse ... [IP-] [ ] media-libs/flac-1.2.1-r3 (0) [IP-] [ ] media-libs/speex-1.2_beta3_p2 (0) - * Searching for USE flag sse2 ... + * Searching for USE flag sse2 ... [IP-] [ ] dev-libs/openssl-0.9.8k (0) [IP-] [ ] x11-libs/pixman-0.16.0 (0) @@ -175,12 +175,12 @@ Globbing support replaced a number of older options in equery. -For example, to act on all packages in a certain set, use '*'. +For example, to act on all packages in a certain set, use '*'. To act on all packages in a category, use 'category-name/*'. -Don't forget to quote input when using special shell characters +Don't forget to quote input when using special shell characters like asterisks or greater than/less than signs. @@ -197,7 +197,7 @@

 $ equery belongs -e /usr/bin/glxgears
- * Searching for /usr/bin/glxgears ... 
+ * Searching for /usr/bin/glxgears ...
  x11-apps/mesa-progs-7.5.1 (/usr/bin/glxgears)
 
@@ -216,7 +216,7 @@

changes lets you view ChangeLog entries for a package version or range -of versions. Imagine after an emerge --sync, you +of versions. Imagine after an emerge --sync, you notice Portage is going to be upgraded and want to check what has changed:

@@ -284,10 +284,10 @@ it will find the packages it depends on (not that depend on it). When it finds a dependency, it will recursively search for all of that package's dependencies. Control how deep the tree gets with -the --depth option. +the --depth option.

-
+
 $ equery depgraph mozilla-firefox
  * Searching for mozilla-firefox ...
  * dependency graph for www-client/mozilla-firefox-2.0.0.19:
@@ -318,7 +318,7 @@
 
 

equery can list all the files installed by an ebuild with the -files command. Try --tree to get an easy to read directory +files module. Try --tree to get an easy to read directory layout. Use --filter to only find a certain type of file. For example, to find where executables were installed, use --filter=cmd, and to quickly find the configuration file location, try --filter=conf. @@ -373,18 +373,18 @@

You can use hasuse to find out which packages have a given USE flag. hasuse won't tell you if the flag is enabled, only if the ebuild lists -it as an option. See the EXAMPLES section of hasuse in the +it as an option. See the EXAMPLES section of hasuse in the equery man page for more tip on getting that information.

 $ equery hasuse qt3 qt4
- * Searching for USE flag qt3 ... 
+ * Searching for USE flag qt3 ...
 [IP-] [  ] app-crypt/pinentry-0.7.5 (0)
 [IP-] [  ] net-dns/avahi-0.6.24-r2 (0)
 [IP-] [  ] net-wireless/wpa_supplicant-0.6.9 (0)
 
- * Searching for USE flag qt4 ... 
+ * Searching for USE flag qt4 ...
 [IP-] [  ] net-dns/avahi-0.6.24-r2 (0)
 [IP-] [  ] net-wireless/wpa_supplicant-0.6.9 (0)
 
@@ -396,8 +396,8 @@

-list is a simple, yet powerful module to list packages that are installed, -in the Portage tree or in an overlay. +list is a simple, yet powerful module to list packages that are +installed, in the Portage tree or in an overlay.

@@ -420,7 +420,7 @@
 
 

The standard query will search installed packages for the given package name. -Passing in '*' displays all packages in the set. In the leftmost field, we +Passing in '*' displays all packages in the set. In the leftmost field, we see that all the above packages are Installed and from the Portage tree. They're not masked (the second field is blank), and they're all installed in the default slot (0). @@ -447,7 +447,7 @@

In this example you can see version 7.2.182 is installed and there are no -versions available from an overlay. You can see which versions are keyword +versions available from an overlay. You can see which versions are keyword masked by the ~ in the second field.

@@ -459,11 +459,11 @@

Each package in the Portage tree provides at least some metadata about -its maintainer, herd, etc. Read about Gentoo -Metadata. The amount of useful information depends on how much package -maintainers decide to provide. With no options, meta returns some basic -useful information. +its maintainer, herd, etc. Read about +Gentoo Metadata. The amount of useful information depends on how much +package maintainers decide to provide. With no options, meta returns +some basic useful information.

@@ -474,8 +474,8 @@
  Upstream:    None specified
  Location:    /usr/portage/app-office/gnucash
  Keywords:    2.2.9-r1:0: alpha amd64 ppc sparc x86
- Keywords:    2.2.9-r2:0: 
- Keywords:    2.3.8:0: 
+ Keywords:    2.2.9-r2:0:
+ Keywords:    2.3.8:0:
  Keywords:    2.3.10:0: ~alpha ~amd64 ~ppc ~sparc ~x86
 
@@ -599,7 +599,7 @@

-Lastly, if none of the above features of equery have answered your +Lastly, if none of the above features of equery have answered your question, try using which to manually search an ebuild with programs like cat, less or grep:

@@ -610,10 +610,10 @@
-Be aware that equery currently changes the format of the output if it is sent -through a pipe. The piped format is intended to be easier to parse by tools, but -you can also turn it off by adding the --no-pipe option. If you write -scripts that employ equery, you should be aware of this. +Be aware that equery currently changes the format of the output if it +is sent through a pipe. The piped format is intended to be easier to parse by +tools, but you can also turn it off by adding the --no-pipe option. If +you write scripts that employ equery, you should be aware of this.