| 1 | <?xml version="1.0" encoding="UTF-8"?> |
1 | <?xml version="1.0" encoding="UTF-8"?> |
| 2 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoolkit.xml,v 1.31 2008/05/20 18:44:03 swift Exp $ --> |
2 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/gentoolkit.xml,v 1.32 2010/06/07 08:12:32 nightmorph Exp $ --> |
| 3 | <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
3 | <!DOCTYPE guide SYSTEM "/dtd/guide.dtd"> |
| 4 | |
4 | |
| 5 | <guide link="/doc/en/gentoolkit.xml"> |
5 | <guide> |
| 6 | <title>Gentoolkit</title> |
6 | <title>Gentoolkit</title> |
| 7 | |
7 | |
| 8 | <author title="Author"> |
8 | <author title="Author"> |
| 9 | <mail link="mbutcher@aleph-null.tv">Matt Butcher</mail> |
9 | <mail link="mbutcher@aleph-null.tv">Matt Butcher</mail> |
| 10 | </author> |
10 | </author> |
| 11 | <author title="Editor"> |
11 | <author title="Editor"> |
| 12 | <!-- zhen@gentoo.org -->John P. Davis |
12 | <!-- zhen@gentoo.org -->John P. Davis |
| 13 | </author> |
13 | </author> |
| 14 | <author title="Editor"> |
14 | <author title="Editor"> |
| 15 | <mail link="erwin@gentoo.org">Erwin</mail> |
15 | <mail link="erwin@gentoo.org">Erwin</mail> |
| 16 | </author> |
16 | </author> |
| 17 | <author title="Editor"> |
17 | <author title="Editor"> |
| 18 | <mail link="fox2mike@gentoo.org">Shyam Mani</mail> |
18 | <mail link="fox2mike@gentoo.org">Shyam Mani</mail> |
| 19 | </author> |
19 | </author> |
| 20 | <author title="Editor"> |
20 | <author title="Editor"> |
| … | |
… | |
| 25 | </author> |
25 | </author> |
| 26 | <author title="Editor"> |
26 | <author title="Editor"> |
| 27 | <mail link="yoswink@gentoo.org">José Luis Rivero</mail> |
27 | <mail link="yoswink@gentoo.org">José Luis Rivero</mail> |
| 28 | </author> |
28 | </author> |
| 29 | <author title="Editor"> |
29 | <author title="Editor"> |
| 30 | <mail link="nightmorph@gentoo.org">Joshua Saddler</mail> |
30 | <mail link="nightmorph@gentoo.org">Joshua Saddler</mail> |
| 31 | </author> |
31 | </author> |
| 32 | |
32 | |
| 33 | <abstract> |
33 | <abstract> |
| 34 | Gentoolkit is a suite of tools to ease the administration of a Gentoo system. |
34 | Gentoolkit is a suite of tools to ease the administration of a Gentoo system. |
| 35 | This document covers the basics of some of the tools present in Gentoolkit. |
35 | This document covers the basics of some of the tools present in Gentoolkit. |
| 36 | </abstract> |
36 | </abstract> |
| 37 | |
37 | |
| 38 | <!-- Licensed under GFDL --> |
38 | <!-- Licensed under GFDL --> |
| 39 | |
39 | |
| 40 | <version>1.12</version> |
40 | <version>1.13</version> |
| 41 | <date>2007-06-25</date> |
41 | <date>2010-06-07</date> |
| 42 | |
42 | |
| 43 | <chapter> |
43 | <chapter> |
| 44 | <title>Introduction</title> |
44 | <title>Introduction</title> |
| 45 | <section> |
45 | <section> |
| 46 | <title>What is Gentoolkit?</title> |
46 | <title>What is Gentoolkit?</title> |
| 47 | <body> |
47 | <body> |
| 48 | |
48 | |
| 49 | <p> |
49 | <p> |
| 50 | Gentoo is a unique distribution and presents some complexities that simply |
50 | Gentoo is a unique distribution and presents some complexities that simply |
| 51 | don't exist for other distributions. As Gentoo developers and contributors |
51 | don't exist for other distributions. As Gentoo developers and contributors |
| 52 | discovered some of these complexities, they also wrote tools to help users and |
52 | discovered some of these complexities, they also wrote tools to help users and |
| 53 | administrators work around them. Many of these tools have been contributed to |
53 | administrators work around them. Many of these tools have been contributed to |
| 54 | the Gentoo project and are included in the package |
54 | the Gentoo project and are included in the package |
| 55 | <c>app-portage/gentoolkit</c>. |
55 | <c>app-portage/gentoolkit</c>. |
| 56 | </p> |
56 | </p> |
| … | |
… | |
| 710 | Now you can remove -p (or --pretend) from arguments and re-run revdep-rebuild. |
710 | Now you can remove -p (or --pretend) from arguments and re-run revdep-rebuild. |
| 711 | </pre> |
711 | </pre> |
| 712 | |
712 | |
| 713 | <p> |
713 | <p> |
| 714 | If you need to rebuild some packages, you may run <c>revdep-rebuild</c> without |
714 | If you need to rebuild some packages, you may run <c>revdep-rebuild</c> without |
| 715 | the <c>-p</c> flag and the listed packages will be emerged again. |
715 | the <c>-p</c> flag and the listed packages will be emerged again. |
| 716 | </p> |
716 | </p> |
| 717 | |
717 | |
| 718 | </body> |
718 | </body> |
| 719 | </section> |
719 | </section> |
| 720 | <section> |
720 | <section> |
| 721 | <title>glsa-check</title> |
721 | <title>glsa-check</title> |
| 722 | <body> |
722 | <body> |
| 723 | |
723 | |
| 724 | <p> |
724 | <p> |
| 725 | <c>glsa-check</c> is mainly a test tool that keeps track of the various GLSA's |
725 | <c>glsa-check</c> is mainly a test tool that keeps track of the various GLSAs |
| 726 | (Gentoo Linux Security Advisory) and will eventually be integrated into |
726 | (Gentoo Linux Security Advisory) and will eventually be integrated into |
| 727 | <c>emerge</c> and <c>equery</c>. For more information, please visit the <uri |
727 | <c>emerge</c> and <c>equery</c>. |
| 728 | link="/proj/en/portage/glsa-integration.xml">Portage GLSA Integration |
|
|
| 729 | Page</uri>. |
|
|
| 730 | </p> |
728 | </p> |
| 731 | |
729 | |
| 732 | </body> |
730 | </body> |
| 733 | </section> |
731 | </section> |
| 734 | <section> |
732 | <section> |
| 735 | <title>eread</title> |
733 | <title>eread</title> |
| 736 | <body> |
734 | <body> |
| 737 | |
735 | |
| 738 | <p> |
736 | <p> |
| 739 | <c>eread</c> is a simple utility to display elog files produced by |
737 | <c>eread</c> is a simple utility to display elog files produced by |
| 740 | >=<c>portage-2.1</c>. You can set the saving of elog files by setting a couple |
738 | >=<c>portage-2.1</c>. You can set the saving of elog files by setting a couple |
| 741 | of variables in <path>/etc/make.conf</path>: |
739 | of variables in <path>/etc/make.conf</path>: |
| 742 | </p> |
740 | </p> |
| 743 | |
741 | |
| 744 | <pre caption="Enabling elog in /etc/make.conf"> |
742 | <pre caption="Enabling elog in /etc/make.conf"> |