yoswink 07/11/01 01:02:41 Modified: hb-working-portage.xml Log: Warn about setting doc USE flag globally (it's known to bring circular dependencies) and recommend doing it per package. Thanks to a random discussion on #-dev
Revision Changes Path 1.66 xml/htdocs/doc/en/handbook/hb-working-portage.xml file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.66&view=markup plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.66&content-type=text/plain diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?r1=1.65&r2=1.66 Index: hb-working-portage.xml =================================================================== RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v retrieving revision 1.65 retrieving revision 1.66 diff -u -r1.65 -r1.66 --- hb-working-portage.xml 21 Oct 2007 19:16:11 -0000 1.65 +++ hb-working-portage.xml 1 Nov 2007 01:02:41 -0000 1.66 @@ -4,7 +4,7 @@ <!-- The content of this document is licensed under the CC-BY-SA license --> <!-- See http://creativecommons.org/licenses/by-sa/2.5 --> -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.65 2007/10/21 19:16:11 nightmorph Exp $ --> +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.66 2007/11/01 01:02:41 yoswink Exp $ --> <sections> @@ -13,8 +13,8 @@ maintain the software on his system. </abstract> -<version>1.59</version> -<date>2007-10-21</date> +<version>1.60</version> +<date>2007-11-01</date> <section> <title>Welcome to Portage</title> @@ -202,10 +202,11 @@ </pre> <p> -You can enable or disable the <c>doc</c> USE flag either globally in the -<path>/etc/make.conf</path> file or per package in -<path>/etc/portage/package.use</path>. The <uri link="?part=2&chap=2">USE -Flags</uri> chapter covers this aspect in detail. +The best way of enable the <c>doc</c> USE flag is doing it per package, in +<path>/etc/portage/package.use</path>, so you get documentation for the packages +you are interested in. Enable the flag globally is known to give problems with +circular dependencies. You can read the chapter about <uri +link="?part=2&chap=2">USE Flags</uri> for more information about them. </p> <p> -- [EMAIL PROTECTED] mailing list
