* [gentoo-doc-cvs] cvs commit: portage-utils.xml
@ 2006-04-30 18:45 Josh Saddler
0 siblings, 0 replies; 4+ messages in thread
From: Josh Saddler @ 2006-04-30 18:45 UTC (permalink / raw
To: gentoo-doc-cvs
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #1: Type: text/plain, Size: 6413 bytes --]
nightmorph 06/04/30 18:45:10
Added: portage-utils.xml
Log:
rane's brand spanking new portage-utils doc is now here, closes bug 123327
Revision Changes Path
1.1 xml/htdocs/doc/en/portage-utils.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/portage-utils.xml?rev=1.1&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/portage-utils.xml?rev=1.1&content-type=text/plain&cvsroot=gentoo
Index: portage-utils.xml
===================================================================
<?xml version='1.0' encoding='UTF-8'?>
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/portage-utils.xml,v 1.1 2006/04/30 18:45:09 nightmorph Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/portage-utils.xml">
<title>Portage-utils</title>
<author title="Author">
<mail link="rane@gentoo.org">Łukasz Damentko</mail>
</author>
<author title="Editor">
<mail link="nightmorph@gentoo.org">Joshua Saddler</mail>
</author>
<author title="Editor">
<mail link="vanquirius@gentoo.org">Marcelo Góes</mail>
</author>
<abstract>
This guide covers some common uses if portage-utils, a set of fast Portage
helper applications written in C.
</abstract>
<!-- The content of this document is licensed under the CC-BY-SA license -->
<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
<license/>
<version>1.0</version>
<date>2006-04-30</date>
<chapter>
<title>Introduction</title>
<section>
<body>
<p>
<c>portage-utils</c> is a collection of very fast utilities written in C, which
are meant to replace their counterparts included in <c>gentoolkit</c>. Although
<c>portage-utils</c> is not yet capable of fully replacing <c>gentoolkit</c>,
its utilities are much more efficient than the equivalent ones from
<c>gentoolkit</c>.
</p>
<p>
The removal of <c>gentoolkit</c> in favor of <c>portage-utils</c> is
discouraged, as <c>gentoolkit</c> contains some functions not implemented in
<c>portage-utils</c> yet, like <c>revdep-rebuild</c> and <c>glsa-check</c>.
Instead, you may want to consider having them both installed.
</p>
<p>
More information about <c>gentoolkit</c> can be found in the <uri
link="/doc/en/gentoolkit.xml">Gentoolkit</uri> guide.
</p>
<p>
You can view the complete list of applications in <c>portage-utils</c> by typing
<c>man q</c> or <c>q --help</c>. Please read the man page for each utility
described, as this guide is only meant to be a short reference for the most
useful functions and does not include all the information about each
application.
</p>
<p>
The first step of using <c>portage-utils</c> is to install the package:
</p>
<pre caption="Installing portage-utils">
# <i>emerge portage-utils</i>
</pre>
</body>
</section>
</chapter>
<chapter>
<title>Usage</title>
<section>
<title>How to find a package to which a file belongs</title>
<body>
<p>
<c>qfile</c> finds the package to which a file belongs:
</p>
<pre caption="Finding the package to which a file belongs">
$ <i>qfile /etc/fonts/fonts.conf</i>
media-libs/fontconfig (/etc/fonts/fonts.conf)
$ <i>qfile /usr/share/keymaps/atari/atari-uk-falcon.map.gz</i>
sys-apps/kbd (/usr/share/keymaps/atari/atari-uk-falcon.map.gz)
</pre>
</body>
</section>
<section>
<title>Verifying package integrity</title>
<body>
<p>
If you want to check MD5 sums or mtimes of the files installed by some package,
you can do it using the <c>qcheck</c> application:
</p>
<pre caption="Checking package integrity">
$ <i>qcheck portage-utils</i>
Checking app-portage/portage-utils-0.1.13 ...
* 36 out of 36 files are good
</pre>
<p>
Of course, all the files which were changed after installation will be reported
here. If the application reports configuration files which you have manually
edited after installation, there's nothing to worry about.
</p>
</body>
</section>
<section>
<title>Listing packages which depend on some package</title>
<body>
<p>
Of course there's also an application which allows you to list all the packages
which depend on some package. This is done using <c>qdepends</c>. Use the
<c>-a</c> flag to show all the DEPEND, RDEPEND, and PDEPEND information for a
package.
</p>
<pre caption="Listing packages which depend on some package">
$ <i>qdepends -a pygtk</i>
* DEPEND
dev-python/pygtk-2.8.2: >=dev-lang/python-2.3 >=x11-libs/gtk+-2.8.0
>=dev-libs/glib-2.8.0 >=x11-libs/pango-1.10.0 >=dev-libs/atk-1.8.0
>=gnome-base/libglade-2.5.0 >=dev-python/pycairo-0.9.0 dev-python/numeric
virtual/opengl dev-python/pyopengl >=x11-libs/gtkglarea-1.99
>=dev-util/pkgconfig-0.9 sys-devel/patch
* RDEPEND
dev-python/pygtk-2.8.2: >=dev-lang/python-2.3 >=x11-libs/gtk+-2.8.0
>=dev-libs/glib-2.8.0 >=x11-libs/pango-1.10.0 >=dev-libs/atk-1.8.0
>=gnome-base/libglade-2.5.0 >=dev-python/pycairo-0.9.0 dev-python/numeric
virtual/opengl dev-python/pyopengl >=x11-libs/gtkglarea-1.99
* PDEPEND
</pre>
</body>
</section>
<section>
<title>Listing files that belong to an ebuild</title>
<body>
<p>
<c>qlist</c> gives you a list of all files that belong to an ebuild.
</p>
<pre caption="Listing files which belong to an ebuild file">
$ <i>qlist vim</i>
/usr/bin/gvim
/usr/bin/gvimdiff
/usr/bin/evim
/usr/bin/eview
/usr/bin/gview
/usr/bin/rgvim
[...]
</pre>
</body>
</section>
<section>
<title>Looking for packages that use some USE flag</title>
<body>
<p>
This is done with <c>quse</c>, which must be run as root. It may take some time
to first create/update the ebuild cache.
</p>
<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 mozilla xml2
dev-haskell/gtk2hs/gtk2hs-0.9.10.ebuild doc glade gnome mozilla firefox
dev-java/swt/swt-3.1-r1.ebuild accessibility cairo firefox gnome mozilla
[...]
</pre>
</body>
</section>
<section>
<title>Finding package sizes</title>
<body>
<p>
This is done with <c>qsize</c> application and is as simple as:
</p>
<pre caption="Finding package size">
$ <i>qsize vim</i>
app-editors/gvim-6.4: 10 files, 7 non-files, 2327.516 KB
app-editors/vim-6.4: 6 files, 2 non-files, 2058.14 KB
app-editors/vim-core-6.4: 1024 files, 68 non-files, 10950.984 KB
[...]
</pre>
</body>
</section>
</chapter>
</guide>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 4+ messages in thread
* [gentoo-doc-cvs] cvs commit: portage-utils.xml
@ 2006-05-01 15:18 Xavier Neys
0 siblings, 0 replies; 4+ messages in thread
From: Xavier Neys @ 2006-05-01 15:18 UTC (permalink / raw
To: gentoo-doc-cvs
neysx 06/05/01 15:18:57
Modified: portage-utils.xml
Log:
#123327 c5 & c11, portage-utils is *NOT* meant to replace gentoolkit
Revision Changes Path
1.2 xml/htdocs/doc/en/portage-utils.xml
file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/portage-utils.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/portage-utils.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/portage-utils.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo
Index: portage-utils.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/portage-utils.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- portage-utils.xml 30 Apr 2006 18:45:09 -0000 1.1
+++ portage-utils.xml 1 May 2006 15:18:57 -0000 1.2
@@ -1,5 +1,5 @@
<?xml version='1.0' encoding='UTF-8'?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/portage-utils.xml,v 1.1 2006/04/30 18:45:09 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/portage-utils.xml,v 1.2 2006/05/01 15:18:57 neysx 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.0</version>
-<date>2006-04-30</date>
+<version>1.1</version>
+<date>2006-05-01</date>
<chapter>
<title>Introduction</title>
@@ -35,17 +35,13 @@
<p>
<c>portage-utils</c> is a collection of very fast utilities written in C, which
-are meant to replace their counterparts included in <c>gentoolkit</c>. Although
-<c>portage-utils</c> is not yet capable of fully replacing <c>gentoolkit</c>,
-its utilities are much more efficient than the equivalent ones from
-<c>gentoolkit</c>.
-</p>
-
-<p>
-The removal of <c>gentoolkit</c> in favor of <c>portage-utils</c> is
-discouraged, as <c>gentoolkit</c> contains some functions not implemented in
-<c>portage-utils</c> yet, like <c>revdep-rebuild</c> and <c>glsa-check</c>.
-Instead, you may want to consider having them both installed.
+are meant to offer a faster but more limited alternative to their
+<c>gentoolkit</c> counterparts. Please note that <c>portage-utils</c> is not
+meant to replace <c>gentoolkit</c>. Its utilities are much more efficient than
+the equivalent ones from <c>gentoolkit</c> and might be better suited to be
+used in scripts that need to call Portage repeatedly, but <c>portage-utils</c>
+does not offer the same functionalities. It does not consider eclasses at all
+and does not provide tools like <c>revdep-rebuild</c> and <c>glsa-check</c>.
</p>
<p>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 4+ messages in thread
* [gentoo-doc-cvs] cvs commit: portage-utils.xml
@ 2007-03-28 20:43 Josh Saddler
0 siblings, 0 replies; 4+ messages in thread
From: Josh Saddler @ 2007-03-28 20:43 UTC (permalink / raw
To: gentoo-doc-cvs
nightmorph 07/03/28 20:43:44
Modified: portage-utils.xml
Log:
typo fix, bug 172593
Revision Changes Path
1.4 xml/htdocs/doc/en/portage-utils.xml
file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/portage-utils.xml?rev=1.4&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/portage-utils.xml?rev=1.4&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/portage-utils.xml?r1=1.3&r2=1.4
Index: portage-utils.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/portage-utils.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- portage-utils.xml 20 Feb 2007 22:07:04 -0000 1.3
+++ portage-utils.xml 28 Mar 2007 20:43:44 -0000 1.4
@@ -1,5 +1,5 @@
<?xml version='1.0' encoding='UTF-8'?>
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/portage-utils.xml,v 1.3 2007/02/20 22:07:04 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/portage-utils.xml,v 1.4 2007/03/28 20:43:44 nightmorph Exp $ -->
<!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
<guide link="/doc/en/portage-utils.xml">
@@ -17,7 +17,7 @@
</author>
<abstract>
-This guide covers some common uses if portage-utils, a set of fast Portage
+This guide covers some common uses of portage-utils, a set of fast Portage
helper applications written in C.
</abstract>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 4+ messages in thread
* [gentoo-doc-cvs] cvs commit: portage-utils.xml
@ 2007-05-23 10:57 Lukasz Damentko
0 siblings, 0 replies; 4+ messages in thread
From: Lukasz Damentko @ 2007-05-23 10:57 UTC (permalink / raw
To: gentoo-doc-cvs
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>
--
gentoo-doc-cvs@gentoo.org mailing list
^ permalink raw reply [flat|nested] 4+ messages in thread
end of thread, other threads:[~2007-05-23 10:57 UTC | newest]
Thread overview: 4+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2006-05-01 15:18 [gentoo-doc-cvs] cvs commit: portage-utils.xml Xavier Neys
-- strict thread matches above, loose matches on Subject: below --
2007-05-23 10:57 Lukasz Damentko
2007-03-28 20:43 Josh Saddler
2006-04-30 18:45 Josh Saddler
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox