| … | |
… | |
| 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.66 2007/11/01 01:02:41 yoswink Exp $ --> |
7 | <!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.67 2007/11/01 01:28:56 jkt Exp $ --> |
| 8 | |
8 | |
| 9 | <sections> |
9 | <sections> |
| 10 | |
10 | |
| 11 | <abstract> |
11 | <abstract> |
| 12 | This chapter explains the "simple" steps a user definitely needs to know to |
12 | This chapter explains the "simple" steps a user definitely needs to know to |
| … | |
… | |
| 200 | # <i>emerge -vp alsa-lib</i> |
200 | # <i>emerge -vp alsa-lib</i> |
| 201 | [ebuild N ] media-libs/alsa-lib-1.0.14_rc1 -debug +doc 698 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> |
| 205 | The best way of enable the <c>doc</c> USE flag is doing it per package, in |
205 | The best way of enabling the <c>doc</c> USE flag is doing it on a per-package |
| 206 | <path>/etc/portage/package.use</path>, so you get documentation for the packages |
206 | basis via the <path>/etc/portage/package.use</path> file, so that you get |
| 207 | you are interested in. Enable the flag globally is known to give problems with |
207 | documentation only for packages that you are interested in. Enabling this flag |
| 208 | circular dependencies. You can read the chapter about <uri |
208 | globally is known to cause problems with circular dependencies. For more |
| 209 | link="?part=2&chap=2">USE Flags</uri> for more information about them. |
209 | information, please read the <uri link="?part=2&chap=2">USE Flags</uri> |
|
|
210 | chapter. |
| 210 | </p> |
211 | </p> |
| 211 | |
212 | |
| 212 | <p> |
213 | <p> |
| 213 | Once the package installed, its documentation is generally found in a |
214 | Once the package installed, its documentation is generally found in a |
| 214 | subdirectory named after the package under the <path>/usr/share/doc</path> |
215 | subdirectory named after the package under the <path>/usr/share/doc</path> |