/[gentoo]/xml/htdocs/doc/en/handbook/hb-working-portage.xml
Gentoo

Diff of /xml/htdocs/doc/en/handbook/hb-working-portage.xml

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.61 Revision 1.62
2<!DOCTYPE sections SYSTEM "/dtd/book.dtd"> 2<!DOCTYPE sections SYSTEM "/dtd/book.dtd">
3 3
4<!-- The content of this document is licensed under the CC-BY-SA license --> 4<!-- The content of this document is licensed under the CC-BY-SA license -->
5<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> 5<!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
6 6
7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.61 2006/11/12 21:28:30 nightmorph Exp $ --> 7<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.62 2007/03/10 01:54:44 nightmorph Exp $ -->
8 8
9<sections> 9<sections>
10 10
11<abstract> 11<abstract>
12This chapter explains the "simple" steps a user definitely needs to know to 12This chapter explains the "simple" steps a user definitely needs to know to
13maintain the software on his system. 13maintain the software on his system.
14</abstract> 14</abstract>
15 15
16<version>1.55</version> 16<version>1.56</version>
17<date>2006-11-12</date> 17<date>2007-03-09</date>
18 18
19<section> 19<section>
20<title>Welcome to Portage</title> 20<title>Welcome to Portage</title>
21<body> 21<body>
22 22
196</p> 196</p>
197 197
198<pre caption="Checking the existence of a doc USE flag"> 198<pre caption="Checking the existence of a doc USE flag">
199<comment>(alsa-lib is just an example, of course.)</comment> 199<comment>(alsa-lib is just an example, of course.)</comment>
200# <i>emerge -vp alsa-lib</i> 200# <i>emerge -vp alsa-lib</i>
201[ebuild N ] media-libs/alsa-lib-1.0.9_rc3 +doc -jack 674 kB 201[ebuild N ] media-libs/alsa-lib-1.0.14_rc1 -debug +doc 698 kB
202</pre> 202</pre>
203 203
204<p> 204<p>
205You can enable or disable the <c>doc</c> USE flag either globally in the 205You can enable or disable the <c>doc</c> USE flag either globally in the
206<path>/etc/make.conf</path> file or per package in the 206<path>/etc/make.conf</path> file or per package in the
207<path>/etc/portage/package.use</path> file. You can also create a directory 207<path>/etc/portage/package.use</path> file. The <uri
208called <path>/etc/portage/package.use</path> and list it in a file inside this
209directory. The <uri
210link="?part=2&amp;chap=2">USE Flags</uri> chapter covers this aspect in detail. 208link="?part=2&amp;chap=2">USE Flags</uri> chapter covers this aspect in detail.
211</p> 209</p>
212 210
213<p> 211<p>
214Once the package installed, its documentation is generally found in a 212Once the package installed, its documentation is generally found in a
217which is part of the <c>app-portage/gentoolkit</c> <uri 215which is part of the <c>app-portage/gentoolkit</c> <uri
218link="/doc/en/gentoolkit.xml">package</uri>. 216link="/doc/en/gentoolkit.xml">package</uri>.
219</p> 217</p>
220 218
221<pre caption="Locating package documentation"> 219<pre caption="Locating package documentation">
222# <i>ls -l /usr/share/doc/alsa-lib-1.0.9_rc3</i> 220# <i>ls -l /usr/share/doc/alsa-lib-1.0.14_rc1</i>
223total 28 221total 28
224-rw-r--r-- 1 root root 669 May 17 21:54 ChangeLog.gz 222-rw-r--r-- 1 root root 669 May 17 21:54 ChangeLog.gz
225-rw-r--r-- 1 root root 9373 May 17 21:54 COPYING.gz 223-rw-r--r-- 1 root root 9373 May 17 21:54 COPYING.gz
226drwxr-xr-x 2 root root 8560 May 17 21:54 html 224drwxr-xr-x 2 root root 8560 May 17 21:54 html
227-rw-r--r-- 1 root root 196 May 17 21:54 TODO.gz 225-rw-r--r-- 1 root root 196 May 17 21:54 TODO.gz
228 226
229<comment>(Alternatively, use equery to locate interesting files:)</comment> 227<comment>(Alternatively, use equery to locate interesting files:)</comment>
230# <i>equery files alsa-lib | less</i> 228# <i>equery files alsa-lib | less</i>
231media-libs/alsa-lib-1.0.9_rc3 229media-libs/alsa-lib-1.0.14_rc1
232* Contents of media-libs/alsa-lib-1.0.9_rc3: 230* Contents of media-libs/alsa-lib-1.0.14_rc1:
233/usr 231/usr
234/usr/bin 232/usr/bin
235/usr/bin/alsalisp 233/usr/bin/alsalisp
236<comment>(Output truncated)</comment> 234<comment>(Output truncated)</comment>
237</pre> 235</pre>

Legend:
Removed from v.1.61  
changed lines
  Added in v.1.62

  ViewVC Help
Powered by ViewVC 1.1.20