Gentoo Archives: gentoo-doc-cvs

From: Jose Luis Rivero <yoswink@××××××××××××.org>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] cvs commit: hb-working-portage.xml
Date: Thu, 01 Nov 2007 01:02:57
Message-Id: E1InOSH-0003Jh-Gd@stork.gentoo.org
1 yoswink 07/11/01 01:02:41
2
3 Modified: hb-working-portage.xml
4 Log:
5 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
6
7 Revision Changes Path
8 1.66 xml/htdocs/doc/en/handbook/hb-working-portage.xml
9
10 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.66&view=markup
11 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.66&content-type=text/plain
12 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?r1=1.65&r2=1.66
13
14 Index: hb-working-portage.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v
17 retrieving revision 1.65
18 retrieving revision 1.66
19 diff -u -r1.65 -r1.66
20 --- hb-working-portage.xml 21 Oct 2007 19:16:11 -0000 1.65
21 +++ hb-working-portage.xml 1 Nov 2007 01:02:41 -0000 1.66
22 @@ -4,7 +4,7 @@
23 <!-- The content of this document is licensed under the CC-BY-SA license -->
24 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
25
26 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.65 2007/10/21 19:16:11 nightmorph Exp $ -->
27 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.66 2007/11/01 01:02:41 yoswink Exp $ -->
28
29 <sections>
30
31 @@ -13,8 +13,8 @@
32 maintain the software on his system.
33 </abstract>
34
35 -<version>1.59</version>
36 -<date>2007-10-21</date>
37 +<version>1.60</version>
38 +<date>2007-11-01</date>
39
40 <section>
41 <title>Welcome to Portage</title>
42 @@ -202,10 +202,11 @@
43 </pre>
44
45 <p>
46 -You can enable or disable the <c>doc</c> USE flag either globally in the
47 -<path>/etc/make.conf</path> file or per package in
48 -<path>/etc/portage/package.use</path>. The <uri link="?part=2&amp;chap=2">USE
49 -Flags</uri> chapter covers this aspect in detail.
50 +The best way of enable the <c>doc</c> USE flag is doing it per package, in
51 +<path>/etc/portage/package.use</path>, so you get documentation for the packages
52 +you are interested in. Enable the flag globally is known to give problems with
53 +circular dependencies. You can read the chapter about <uri
54 +link="?part=2&amp;chap=2">USE Flags</uri> for more information about them.
55 </p>
56
57 <p>
58
59
60
61 --
62 gentoo-doc-cvs@g.o mailing list