Gentoo Archives: gentoo-doc-cvs

From: swift <swift@×××××××××××.org>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] cvs commit: hb-portage-branches.xml hb-working-portage.xml
Date: Tue, 01 Aug 2006 17:35:24
Message-Id: 20060801173506.2D10F64665@smtp.gentoo.org
1 swift 06/08/01 17:35:06
2
3 Modified: hb-portage-branches.xml hb-working-portage.xml
4 Log:
5 Portage supports directories as well
6
7 Revision Changes Path
8 1.14 xml/htdocs/doc/en/handbook/hb-portage-branches.xml
9
10 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-portage-branches.xml?rev=1.14&view=markup
11 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-portage-branches.xml?rev=1.14&content-type=text/plain
12 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-portage-branches.xml?r1=1.13&r2=1.14
13
14 Index: hb-portage-branches.xml
15 ===================================================================
16 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-portage-branches.xml,v
17 retrieving revision 1.13
18 retrieving revision 1.14
19 diff -u -r1.13 -r1.14
20 --- hb-portage-branches.xml 14 Mar 2006 19:29:29 -0000 1.13
21 +++ hb-portage-branches.xml 1 Aug 2006 17:35:05 -0000 1.14
22 @@ -4,12 +4,12 @@
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-portage-branches.xml,v 1.13 2006/03/14 19:29:29 neysx Exp $ -->
27 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-portage-branches.xml,v 1.14 2006/08/01 17:35:05 swift Exp $ -->
28
29 <sections>
30
31 -<version>1.6</version>
32 -<date>2005-08-11</date>
33 +<version>1.7</version>
34 +<date>2006-08-01</date>
35
36 <section>
37 <title>Using One Branch</title>
38 @@ -80,15 +80,16 @@
39 <section>
40 <title>Mixing Stable with Testing</title>
41 <subsection>
42 -<title>The package.keywords file</title>
43 +<title>The package.keywords location</title>
44 <body>
45
46 <p>
47 You can ask Portage to allow the testing branch for particular packages but use
48 the stable branch for the rest of the system. To achieve this, add the package
49 category and name you want to use the testing branch of in
50 -<path>/etc/portage/package.keywords</path>. For instance, to use the testing
51 -branch for <c>gnumeric</c>:
52 +<path>/etc/portage/package.keywords</path>. You can also create a directory
53 +(with the same name) and list the package in the files under that directory.
54 +For instance, to use the testing branch for <c>gnumeric</c>:
55 </p>
56
57 <pre caption="/etc/portage/package.keywords setting for gnumeric, full line">
58 @@ -104,8 +105,8 @@
59 <p>
60 If you want to use a specific software version from the testing branch but you
61 don't want Portage to use the testing branch for subsequent versions, you can
62 -add in the version in the <path>package.keywords</path> file. In this case you
63 -<e>must</e> use the = operator. You can also enter a version range
64 +add in the version in the <path>package.keywords</path> location. In this case
65 +you <e>must</e> use the = operator. You can also enter a version range
66 using the &lt;=, &lt;, &gt; or &gt;= operators.
67 </p>
68
69 @@ -128,11 +129,11 @@
70 <section>
71 <title>Using Masked Packages</title>
72 <subsection>
73 -<title>The package.unmask file</title>
74 +<title>The package.unmask location</title>
75 <body>
76
77 <p>
78 -The Gentoo developers do <b>not</b> support the use of these files. Please
79 +The Gentoo developers do <b>not</b> support the use of this location. Please
80 exercise due caution when doing so. Support requests related to
81 <c>package.unmask</c> and/or <c>package.mask</c> will not be answered. You have
82 been warned.
83 @@ -142,12 +143,13 @@
84 When a package has been masked by the Gentoo developers and you still want to
85 use it despite the reason mentioned in the <path>package.mask</path> file
86 (situated in <path>/usr/portage/profiles</path> by default), add the
87 -<e>exact</e> same line in <path>/etc/portage/package.unmask</path>.
88 +<e>exact</e> same line in the <path>/etc/portage/package.unmask</path> file
89 +(or in a file in that directory if it is a directory).
90 </p>
91
92 <p>
93 For instance, if <c>=net-mail/hotwayd-0.8</c> is masked, you can unmask it by
94 -adding the exact same line in the <path>package.unmask</path> file:
95 +adding the exact same line in the <path>package.unmask</path> location:
96 </p>
97
98 <pre caption="/etc/portage/package.unmask">
99 @@ -157,19 +159,20 @@
100 </body>
101 </subsection>
102 <subsection>
103 -<title>The package.mask file</title>
104 +<title>The package.mask location</title>
105 <body>
106
107 <p>
108 When you don't want Portage to take a certain package or a specific version of a
109 package into account you can mask it yourself by adding an appropriate line to
110 -<path>/etc/portage/package.mask</path>.
111 +the <path>/etc/portage/package.mask</path> location (either in that file or
112 +in a file in this directory).
113 </p>
114
115 <p>
116 For instance, if you don't want Portage to install newer kernel sources than
117 -<c>gentoo-sources-2.6.8.1</c>, you add the following line to
118 -<path>package.mask</path>:
119 +<c>gentoo-sources-2.6.8.1</c>, you add the following line at the
120 +<path>package.mask</path> location:
121 </p>
122
123 <pre caption="/etc/portage/package.mask example">
124
125
126
127 1.58 xml/htdocs/doc/en/handbook/hb-working-portage.xml
128
129 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.58&view=markup
130 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?rev=1.58&content-type=text/plain
131 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml?r1=1.57&r2=1.58
132
133 Index: hb-working-portage.xml
134 ===================================================================
135 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v
136 retrieving revision 1.57
137 retrieving revision 1.58
138 diff -u -r1.57 -r1.58
139 --- hb-working-portage.xml 26 Dec 2005 16:47:16 -0000 1.57
140 +++ hb-working-portage.xml 1 Aug 2006 17:35:05 -0000 1.58
141 @@ -4,12 +4,12 @@
142 <!-- The content of this document is licensed under the CC-BY-SA license -->
143 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
144
145 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.57 2005/12/26 16:47:16 swift Exp $ -->
146 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-working-portage.xml,v 1.58 2006/08/01 17:35:05 swift Exp $ -->
147
148 <sections>
149
150 -<version>1.52</version>
151 -<date>2005-12-26</date>
152 +<version>1.53</version>
153 +<date>2006-08-01</date>
154
155 <section>
156 <title>Welcome to Portage</title>
157 @@ -199,7 +199,9 @@
158 <p>
159 You can enable or disable the <c>doc</c> USE flag either globally in the
160 <path>/etc/make.conf</path> file or per package in the
161 -<path>/etc/portage/package.use</path> file. The <uri
162 +<path>/etc/portage/package.use</path> file. You can also create a directory
163 +called <path>/etc/portage/package.use</path> and list it in a file inside this
164 +directory. The <uri
165 link="?part=2&amp;chap=2">USE Flags</uri> chapter covers this aspect in detail.
166 </p>
167
168
169
170
171 --
172 gentoo-doc-cvs@g.o mailing list