rane 07/05/23 10:57:01 Modified: portage-utils.xml Log: updated with information on qsearch and qlop, thanks to nightmorph for proof-reading and fixing my english
Revision Changes Path 1.5 xml/htdocs/doc/en/portage-utils.xml file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/portage-utils.xml?rev=1.5&view=markup plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/portage-utils.xml?rev=1.5&content-type=text/plain diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/portage-utils.xml?r1=1.4&r2=1.5 Index: portage-utils.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/portage-utils.xml,v retrieving revision 1.4 retrieving revision 1.5 diff -u -r1.4 -r1.5 --- portage-utils.xml 28 Mar 2007 20:43:44 -0000 1.4 +++ portage-utils.xml 23 May 2007 10:57:01 -0000 1.5 @@ -1,5 +1,5 @@ <?xml version='1.0' encoding='UTF-8'?> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/portage-utils.xml,v 1.4 2007/03/28 20:43:44 nightmorph Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/portage-utils.xml,v 1.5 2007/05/23 10:57:01 rane Exp $ --> <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> <guide link="/doc/en/portage-utils.xml"> @@ -25,8 +25,8 @@ <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> <license/> -<version>1.2</version> -<date>2007-02-20</date> +<version>1.3</version> +<date>2007-05-23</date> <chapter> <title>Introduction</title> @@ -172,9 +172,9 @@ <pre caption="Looking for packages with the 'firefox' USE flag"> # <i>quse firefox</i> -app-office/openoffice/openoffice-2.0.2_rc1.ebuild binfilter curl eds firefox gnome gtk java kde ldap xml2 -dev-haskell/gtk2hs/gtk2hs-0.9.10.ebuild doc glade gnome firefox -dev-java/swt/swt-3.1-r1.ebuild accessibility cairo firefox gnome +app-office/openoffice/openoffice-2.0.2_rc1.ebuild binfilter curl eds firefox gnome gtk java kde ldap xml2 +dev-haskell/gtk2hs/gtk2hs-0.9.10.ebuild doc glade gnome firefox +dev-java/swt/swt-3.1-r1.ebuild accessibility cairo firefox gnome [...] </pre> @@ -198,5 +198,68 @@ </body> </section> +<section> +<title>Searching the Portage tree</title> +<body> + +<p> +One of the most powerful tools of <c>portage-utils</c> is <c>qsearch</c>. This +tool allows you to search your Portage tree much faster than default <c>emerge +-s</c>. +</p> + +<p> +Here are some examples of its usage: +</p> + +<pre caption="Using qsearch to search the tree"> +<comment>(I forgot the name of the package with my favorite fonts)</comment> +$ <i>qsearch terminus</i> +media-fonts/terminus-font A clean fixed font for the console and X11 + +<comment>(I want to thank the guy who made them. What's his homepage?)</comment> +$ <i>qsearch -H terminus</i> +media-fonts/terminus-font http://www.is-vn.bg/hamster/jimmy-en.html + +<comment>(I need a jabber client and I need it now)</comment> +$ <i>qsearch -S "jabber client"</i> +app-emacs/emacs-jabber A Jabber client for Emacs. +net-im/gajim Jabber client written in PyGTK +net-im/gnome-jabber Gnome Jabber Client +net-im/gossip Lightweight Jabber client for GNOME +net-im/imcom Python commandline Jabber Client +net-im/psi QT 3.x Jabber Client, with Licq-like interface +net-im/tkabber Featureful Jabber client for tcl/tk. +x11-themes/psi-themes Iconsets for Psi, a QT 3.x Jabber Client +</pre> + +</body> +</section> +<section> +<title>Extracting information from emerge logs</title> +<body> + +<p> +There is also a tool that allows you to extract useful information from your +<path>emerge.log</path> file. It's called <c>qlop</c> and it can be useful when +you want to estimate package compilation times or compare with your friends +whose computer compiles faster. It also allows you to check what's compiling at +the moment and how long it will take - which is handy when you're working in the +console and don't have any other means to check it. +</p> + +<pre caption="Reading emerge logs with qlop"> +<comment>(I'm starting to emerge perl and I want an estimate on how long it usually takes)</comment> +$ <i>qlop -tH perl</i> +perl: 7 minutes, 52 seconds for 4 merges +<comment>(Now let's see what's emerging at the moment)</comment> +$ <i>qlop -c</i> +* perl-5.8.8-r23 + started: Mon May 21 12:41:11 2007 + elapsed: 19 seconds +</pre> + +</body> +</section> </chapter> </guide> -- [EMAIL PROTECTED] mailing list
