Gentoo Archives: gentoo-doc-cvs

From: Lukasz Damentko <rane@××××××××××××.org>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] cvs commit: portage-utils.xml
Date: Wed, 23 May 2007 10:57:18
Message-Id: E1HqoWb-0005tq-L2@stork.gentoo.org
1 rane 07/05/23 10:57:01
2
3 Modified: portage-utils.xml
4 Log:
5 updated with information on qsearch and qlop, thanks to nightmorph for proof-reading and fixing my english
6
7 Revision Changes Path
8 1.5 xml/htdocs/doc/en/portage-utils.xml
9
10 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/portage-utils.xml?rev=1.5&view=markup
11 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/portage-utils.xml?rev=1.5&content-type=text/plain
12 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/portage-utils.xml?r1=1.4&r2=1.5
13
14 Index: portage-utils.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/portage-utils.xml,v
17 retrieving revision 1.4
18 retrieving revision 1.5
19 diff -u -r1.4 -r1.5
20 --- portage-utils.xml 28 Mar 2007 20:43:44 -0000 1.4
21 +++ portage-utils.xml 23 May 2007 10:57:01 -0000 1.5
22 @@ -1,5 +1,5 @@
23 <?xml version='1.0' encoding='UTF-8'?>
24 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/portage-utils.xml,v 1.4 2007/03/28 20:43:44 nightmorph Exp $ -->
25 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/portage-utils.xml,v 1.5 2007/05/23 10:57:01 rane Exp $ -->
26 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
27
28 <guide link="/doc/en/portage-utils.xml">
29 @@ -25,8 +25,8 @@
30 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
31 <license/>
32
33 -<version>1.2</version>
34 -<date>2007-02-20</date>
35 +<version>1.3</version>
36 +<date>2007-05-23</date>
37
38 <chapter>
39 <title>Introduction</title>
40 @@ -172,9 +172,9 @@
41
42 <pre caption="Looking for packages with the 'firefox' USE flag">
43 # <i>quse firefox</i>
44 -app-office/openoffice/openoffice-2.0.2_rc1.ebuild binfilter curl eds firefox gnome gtk java kde ldap xml2
45 -dev-haskell/gtk2hs/gtk2hs-0.9.10.ebuild doc glade gnome firefox
46 -dev-java/swt/swt-3.1-r1.ebuild accessibility cairo firefox gnome
47 +app-office/openoffice/openoffice-2.0.2_rc1.ebuild binfilter curl eds firefox gnome gtk java kde ldap xml2
48 +dev-haskell/gtk2hs/gtk2hs-0.9.10.ebuild doc glade gnome firefox
49 +dev-java/swt/swt-3.1-r1.ebuild accessibility cairo firefox gnome
50 [...]
51 </pre>
52
53 @@ -198,5 +198,68 @@
54
55 </body>
56 </section>
57 +<section>
58 +<title>Searching the Portage tree</title>
59 +<body>
60 +
61 +<p>
62 +One of the most powerful tools of <c>portage-utils</c> is <c>qsearch</c>. This
63 +tool allows you to search your Portage tree much faster than default <c>emerge
64 +-s</c>.
65 +</p>
66 +
67 +<p>
68 +Here are some examples of its usage:
69 +</p>
70 +
71 +<pre caption="Using qsearch to search the tree">
72 +<comment>(I forgot the name of the package with my favorite fonts)</comment>
73 +$ <i>qsearch terminus</i>
74 +media-fonts/terminus-font A clean fixed font for the console and X11
75 +
76 +<comment>(I want to thank the guy who made them. What's his homepage?)</comment>
77 +$ <i>qsearch -H terminus</i>
78 +media-fonts/terminus-font http://www.is-vn.bg/hamster/jimmy-en.html
79 +
80 +<comment>(I need a jabber client and I need it now)</comment>
81 +$ <i>qsearch -S "jabber client"</i>
82 +app-emacs/emacs-jabber A Jabber client for Emacs.
83 +net-im/gajim Jabber client written in PyGTK
84 +net-im/gnome-jabber Gnome Jabber Client
85 +net-im/gossip Lightweight Jabber client for GNOME
86 +net-im/imcom Python commandline Jabber Client
87 +net-im/psi QT 3.x Jabber Client, with Licq-like interface
88 +net-im/tkabber Featureful Jabber client for tcl/tk.
89 +x11-themes/psi-themes Iconsets for Psi, a QT 3.x Jabber Client
90 +</pre>
91 +
92 +</body>
93 +</section>
94 +<section>
95 +<title>Extracting information from emerge logs</title>
96 +<body>
97 +
98 +<p>
99 +There is also a tool that allows you to extract useful information from your
100 +<path>emerge.log</path> file. It's called <c>qlop</c> and it can be useful when
101 +you want to estimate package compilation times or compare with your friends
102 +whose computer compiles faster. It also allows you to check what's compiling at
103 +the moment and how long it will take - which is handy when you're working in the
104 +console and don't have any other means to check it.
105 +</p>
106 +
107 +<pre caption="Reading emerge logs with qlop">
108 +<comment>(I'm starting to emerge perl and I want an estimate on how long it usually takes)</comment>
109 +$ <i>qlop -tH perl</i>
110 +perl: 7 minutes, 52 seconds for 4 merges
111 +<comment>(Now let's see what's emerging at the moment)</comment>
112 +$ <i>qlop -c</i>
113 +* perl-5.8.8-r23
114 + started: Mon May 21 12:41:11 2007
115 + elapsed: 19 seconds
116 +</pre>
117 +
118 +</body>
119 +</section>
120 </chapter>
121 </guide>
122
123
124
125 --
126 gentoo-doc-cvs@g.o mailing list