From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from pigeon.gentoo.org ([208.92.234.80] helo=lists.gentoo.org) by finch.gentoo.org with esmtp (Exim 4.60) (envelope-from ) id 1Qt2s2-00022c-AJ for garchives@archives.gentoo.org; Mon, 15 Aug 2011 19:30:46 +0000 Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 9D9BA21C2BA; Mon, 15 Aug 2011 19:30:38 +0000 (UTC) Received: from smtp.gentoo.org (smtp.gentoo.org [140.211.166.183]) by pigeon.gentoo.org (Postfix) with ESMTP id 4E0E121C2BA for ; Mon, 15 Aug 2011 19:30:38 +0000 (UTC) Received: from flycatcher.gentoo.org (flycatcher.gentoo.org [81.93.255.6]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id A25951B403B for ; Mon, 15 Aug 2011 19:30:37 +0000 (UTC) Received: by flycatcher.gentoo.org (Postfix, from userid 617) id 593372004C; Mon, 15 Aug 2011 19:30:36 +0000 (UTC) From: "Sven Vermeulen (swift)" To: gentoo-doc-cvs@lists.gentoo.org Subject: [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en: gentoolkit.xml X-VCS-Repository: gentoo X-VCS-Files: gentoolkit.xml X-VCS-Directories: xml/htdocs/doc/en X-VCS-Committer: swift X-VCS-Committer-Name: Sven Vermeulen Content-Type: text/plain; charset=utf8 Message-Id: <20110815193036.593372004C@flycatcher.gentoo.org> Date: Mon, 15 Aug 2011 19:30:36 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-doc-cvs@lists.gentoo.org Reply-to: docs-team@lists.gentoo.org Content-Transfer-Encoding: quoted-printable X-Archives-Salt: X-Archives-Hash: 8a2ec3e29eaa8e4def3ee00c7e495fa8 swift 11/08/15 19:30:36 Modified: gentoolkit.xml Log: Coding style updates, thanks to Chema Alonso (nimiux) Revision Changes Path 1.36 xml/htdocs/doc/en/gentoolkit.xml file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/gent= oolkit.xml?rev=3D1.36&view=3Dmarkup plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/gent= oolkit.xml?rev=3D1.36&content-type=3Dtext/plain diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/gent= oolkit.xml?r1=3D1.35&r2=3D1.36 Index: gentoolkit.xml =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D= =3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoolkit.xml,v retrieving revision 1.35 retrieving revision 1.36 diff -u -r1.35 -r1.36 --- gentoolkit.xml 15 Aug 2011 19:29:48 -0000 1.35 +++ gentoolkit.xml 15 Aug 2011 19:30:36 -0000 1.36 @@ -1,5 +1,5 @@ - + =20 @@ -41,7 +41,7 @@ =20 4 -2011-08-15 +2011-08-16 =20 Introduction @@ -117,10 +117,10 @@ =20

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

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

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

=20 @@ -284,7 +284,7 @@ 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.=20 +the --depth option.

=20
@@ -373,18 +373,18 @@
 

You can use hasuse to find out which packages have a given USE fl= ag. 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=20 +it as an option. See the EXAMPLES section of hasuse in the equery man page for more tip on getting that information.

=20
 $ equery hasuse qt3 qt4
- * Searching for USE flag qt3 ...=20
+ * 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)
=20
- * Searching for USE flag qt4 ...=20
+ * 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 @@ =20

-list is a simple, yet powerful module to list packages that are i= nstalled, -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.

=20
@@ -420,7 +420,7 @@
=20
 

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=20 +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 in= stalled in the default slot (0). @@ -447,7 +447,7 @@ =20

In this example you can see version 7.2.182 is installed and there are n= o -versions available from an overlay. You can see which versions are keywo= rd=20 +versions available from an overlay. You can see which versions are keywo= rd masked by the ~ in the second field.

=20 @@ -459,11 +459,11 @@ =20

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 pac= kage -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 m= uch +package maintainers decide to provide. With no options, meta retu= rns +some basic useful information.

=20
@@ -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:=20
- Keywords:    2.3.8:0:=20
+ Keywords:    2.2.9-r2:0:
+ Keywords:    2.3.8:0:
  Keywords:    2.3.10:0: ~alpha ~amd64 ~ppc ~sparc ~x86
 
=20 @@ -599,7 +599,7 @@
=20

-Lastly, if none of the above features of equery have answered you= r=20 +Lastly, if none of the above features of equery have answered you= r question, try using which to manually search an ebuild with progr= ams like cat, less or grep:

@@ -610,10 +610,10 @@
=20 -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 to= ols, but -you can also turn it off by adding the --no-pipe option. If you w= rite -scripts that employ equery, you should be aware of this. +Be aware that equery currently changes the format of the output i= f it +is sent through a pipe. The piped format is intended to be easier to par= se by +tools, but you can also turn it off by adding the --no-pipe optio= n. If +you write scripts that employ equery, you should be aware of this= . =20