1 |
swift 12/01/15 09:55:35 |
2 |
|
3 |
Modified: handbook-alpha.xml handbook-amd64.xml |
4 |
handbook-arm.xml handbook-hppa.xml |
5 |
handbook-ia64.xml handbook-mips.xml |
6 |
handbook-ppc.xml handbook-ppc64.xml |
7 |
handbook-sparc.xml handbook-x86.xml |
8 |
Added: hb-portage-advanced.xml |
9 |
Log: |
10 |
Fix bug #396549 - Add section on advanced portage features |
11 |
|
12 |
Revision Changes Path |
13 |
1.141 xml/htdocs/doc/en/handbook/handbook-alpha.xml |
14 |
|
15 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml?rev=1.141&view=markup |
16 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml?rev=1.141&content-type=text/plain |
17 |
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml?r1=1.140&r2=1.141 |
18 |
|
19 |
Index: handbook-alpha.xml |
20 |
=================================================================== |
21 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml,v |
22 |
retrieving revision 1.140 |
23 |
retrieving revision 1.141 |
24 |
diff -u -r1.140 -r1.141 |
25 |
--- handbook-alpha.xml 20 Jul 2010 02:22:04 -0000 1.140 |
26 |
+++ handbook-alpha.xml 15 Jan 2012 09:55:35 -0000 1.141 |
27 |
@@ -1,7 +1,7 @@ |
28 |
<?xml version='1.0' encoding='UTF-8'?> |
29 |
<!DOCTYPE book SYSTEM "/dtd/book.dtd"> |
30 |
|
31 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml,v 1.140 2010/07/20 02:22:04 nightmorph Exp $ --> |
32 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-alpha.xml,v 1.141 2012/01/15 09:55:35 swift Exp $ --> |
33 |
|
34 |
<book> |
35 |
<title>Gentoo Linux Alpha Handbook</title> |
36 |
@@ -138,8 +138,8 @@ |
37 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
38 |
<license/> |
39 |
|
40 |
-<version>10.1</version> |
41 |
-<date>2010-07-19</date> |
42 |
+<version>11.0</version> |
43 |
+<date>2012-01-15</date> |
44 |
|
45 |
<part> |
46 |
<title>Installing Gentoo</title> |
47 |
@@ -291,6 +291,12 @@ |
48 |
<title>Diverting from the Official Tree</title> |
49 |
<include href="hb-portage-diverttree.xml"/> |
50 |
</chapter> |
51 |
+ |
52 |
+<chapter> |
53 |
+<title>Advanced Portage Features</title> |
54 |
+ <include href="hb-portage-advanced.xml" /> |
55 |
+</chapter> |
56 |
+ |
57 |
</part> |
58 |
|
59 |
<part> |
60 |
|
61 |
|
62 |
|
63 |
1.154 xml/htdocs/doc/en/handbook/handbook-amd64.xml |
64 |
|
65 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-amd64.xml?rev=1.154&view=markup |
66 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-amd64.xml?rev=1.154&content-type=text/plain |
67 |
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-amd64.xml?r1=1.153&r2=1.154 |
68 |
|
69 |
Index: handbook-amd64.xml |
70 |
=================================================================== |
71 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-amd64.xml,v |
72 |
retrieving revision 1.153 |
73 |
retrieving revision 1.154 |
74 |
diff -u -r1.153 -r1.154 |
75 |
--- handbook-amd64.xml 20 Jul 2010 02:09:27 -0000 1.153 |
76 |
+++ handbook-amd64.xml 15 Jan 2012 09:55:35 -0000 1.154 |
77 |
@@ -1,7 +1,7 @@ |
78 |
<?xml version='1.0' encoding='UTF-8'?> |
79 |
<!DOCTYPE book SYSTEM "/dtd/book.dtd"> |
80 |
|
81 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-amd64.xml,v 1.153 2010/07/20 02:09:27 nightmorph Exp $ --> |
82 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-amd64.xml,v 1.154 2012/01/15 09:55:35 swift Exp $ --> |
83 |
|
84 |
<book> |
85 |
<title>Gentoo Linux AMD64 Handbook</title> |
86 |
@@ -141,8 +141,8 @@ |
87 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
88 |
<license/> |
89 |
|
90 |
-<version>10.2</version> |
91 |
-<date>2010-07-19</date> |
92 |
+<version>11.0</version> |
93 |
+<date>2012-01-15</date> |
94 |
|
95 |
<part> |
96 |
<title>Installing Gentoo</title> |
97 |
@@ -280,6 +280,11 @@ |
98 |
<title>Diverting from the Official Tree</title> |
99 |
<include href="hb-portage-diverttree.xml"/> |
100 |
</chapter> |
101 |
+ |
102 |
+<chapter> |
103 |
+<title>Advanced Portage Features</title> |
104 |
+ <include href="hb-portage-advanced.xml" /> |
105 |
+</chapter> |
106 |
</part> |
107 |
|
108 |
<part> |
109 |
|
110 |
|
111 |
|
112 |
1.75 xml/htdocs/doc/en/handbook/handbook-arm.xml |
113 |
|
114 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-arm.xml?rev=1.75&view=markup |
115 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-arm.xml?rev=1.75&content-type=text/plain |
116 |
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-arm.xml?r1=1.74&r2=1.75 |
117 |
|
118 |
Index: handbook-arm.xml |
119 |
=================================================================== |
120 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-arm.xml,v |
121 |
retrieving revision 1.74 |
122 |
retrieving revision 1.75 |
123 |
diff -u -r1.74 -r1.75 |
124 |
--- handbook-arm.xml 17 May 2011 22:33:01 -0000 1.74 |
125 |
+++ handbook-arm.xml 15 Jan 2012 09:55:35 -0000 1.75 |
126 |
@@ -1,7 +1,7 @@ |
127 |
<?xml version='1.0' encoding='UTF-8'?> |
128 |
<!DOCTYPE book SYSTEM "/dtd/book.dtd"> |
129 |
|
130 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-arm.xml,v 1.74 2011/05/17 22:33:01 nightmorph Exp $ --> |
131 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-arm.xml,v 1.75 2012/01/15 09:55:35 swift Exp $ --> |
132 |
|
133 |
<book> |
134 |
<title>Gentoo Linux ARM Handbook</title> |
135 |
@@ -138,8 +138,8 @@ |
136 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
137 |
<license/> |
138 |
|
139 |
-<version>11</version> |
140 |
-<date>2011-05-17</date> |
141 |
+<version>12</version> |
142 |
+<date>2012-01-15</date> |
143 |
|
144 |
<part> |
145 |
<title>Installing Gentoo</title> |
146 |
@@ -288,6 +288,11 @@ |
147 |
<title>Diverting from the Official Tree</title> |
148 |
<include href="hb-portage-diverttree.xml"/> |
149 |
</chapter> |
150 |
+ |
151 |
+<chapter> |
152 |
+<title>Advanced Portage Features</title> |
153 |
+ <include href="hb-portage-advanced.xml" /> |
154 |
+</chapter> |
155 |
</part> |
156 |
|
157 |
<part> |
158 |
|
159 |
|
160 |
|
161 |
1.139 xml/htdocs/doc/en/handbook/handbook-hppa.xml |
162 |
|
163 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml?rev=1.139&view=markup |
164 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml?rev=1.139&content-type=text/plain |
165 |
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml?r1=1.138&r2=1.139 |
166 |
|
167 |
Index: handbook-hppa.xml |
168 |
=================================================================== |
169 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml,v |
170 |
retrieving revision 1.138 |
171 |
retrieving revision 1.139 |
172 |
diff -u -r1.138 -r1.139 |
173 |
--- handbook-hppa.xml 20 Jul 2010 00:05:24 -0000 1.138 |
174 |
+++ handbook-hppa.xml 15 Jan 2012 09:55:35 -0000 1.139 |
175 |
@@ -1,6 +1,6 @@ |
176 |
<?xml version='1.0' encoding='UTF-8'?> |
177 |
<!DOCTYPE book SYSTEM "/dtd/book.dtd"> |
178 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml,v 1.138 2010/07/20 00:05:24 nightmorph Exp $ --> |
179 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml,v 1.139 2012/01/15 09:55:35 swift Exp $ --> |
180 |
|
181 |
<book> |
182 |
<title>Gentoo Linux HPPA Handbook</title> |
183 |
@@ -137,8 +137,8 @@ |
184 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
185 |
<license/> |
186 |
|
187 |
-<version>10.0</version> |
188 |
-<date>2010-07-19</date> |
189 |
+<version>11.0</version> |
190 |
+<date>2012-01-15</date> |
191 |
|
192 |
<part> |
193 |
<title>Installing Gentoo</title> |
194 |
@@ -289,6 +289,11 @@ |
195 |
<title>Diverting from the Official Tree</title> |
196 |
<include href="hb-portage-diverttree.xml"/> |
197 |
</chapter> |
198 |
+ |
199 |
+<chapter> |
200 |
+<title>Advanced Portage Features</title> |
201 |
+ <include href="hb-portage-advanced.xml" /> |
202 |
+</chapter> |
203 |
</part> |
204 |
|
205 |
<part> |
206 |
|
207 |
|
208 |
|
209 |
1.15 xml/htdocs/doc/en/handbook/handbook-ia64.xml |
210 |
|
211 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-ia64.xml?rev=1.15&view=markup |
212 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-ia64.xml?rev=1.15&content-type=text/plain |
213 |
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-ia64.xml?r1=1.14&r2=1.15 |
214 |
|
215 |
Index: handbook-ia64.xml |
216 |
=================================================================== |
217 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ia64.xml,v |
218 |
retrieving revision 1.14 |
219 |
retrieving revision 1.15 |
220 |
diff -u -r1.14 -r1.15 |
221 |
--- handbook-ia64.xml 20 Jul 2010 05:14:55 -0000 1.14 |
222 |
+++ handbook-ia64.xml 15 Jan 2012 09:55:35 -0000 1.15 |
223 |
@@ -1,6 +1,6 @@ |
224 |
<?xml version='1.0' encoding='UTF-8'?> |
225 |
<!DOCTYPE book SYSTEM "/dtd/book.dtd"> |
226 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ia64.xml,v 1.14 2010/07/20 05:14:55 nightmorph Exp $ --> |
227 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ia64.xml,v 1.15 2012/01/15 09:55:35 swift Exp $ --> |
228 |
|
229 |
<book> |
230 |
<title>Gentoo Linux/IA64 Handbook</title> |
231 |
@@ -145,8 +145,8 @@ |
232 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
233 |
<license/> |
234 |
|
235 |
-<version>10.0</version> |
236 |
-<date>2010-07-19</date> |
237 |
+<version>11.0</version> |
238 |
+<date>2012-01-15</date> |
239 |
|
240 |
<part> |
241 |
<title>Installing Gentoo</title> |
242 |
@@ -296,6 +296,11 @@ |
243 |
<title>Diverting from the Official Tree</title> |
244 |
<include href="hb-portage-diverttree.xml"/> |
245 |
</chapter> |
246 |
+ |
247 |
+<chapter> |
248 |
+<title>Advanced Portage Features</title> |
249 |
+ <include href="hb-portage-advanced.xml" /> |
250 |
+</chapter> |
251 |
</part> |
252 |
|
253 |
<part> |
254 |
|
255 |
|
256 |
|
257 |
1.126 xml/htdocs/doc/en/handbook/handbook-mips.xml |
258 |
|
259 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-mips.xml?rev=1.126&view=markup |
260 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-mips.xml?rev=1.126&content-type=text/plain |
261 |
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-mips.xml?r1=1.125&r2=1.126 |
262 |
|
263 |
Index: handbook-mips.xml |
264 |
=================================================================== |
265 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-mips.xml,v |
266 |
retrieving revision 1.125 |
267 |
retrieving revision 1.126 |
268 |
diff -u -r1.125 -r1.126 |
269 |
--- handbook-mips.xml 27 Jul 2010 22:54:33 -0000 1.125 |
270 |
+++ handbook-mips.xml 15 Jan 2012 09:55:35 -0000 1.126 |
271 |
@@ -1,7 +1,7 @@ |
272 |
<?xml version='1.0' encoding='UTF-8'?> |
273 |
<!DOCTYPE book SYSTEM "/dtd/book.dtd"> |
274 |
|
275 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-mips.xml,v 1.125 2010/07/27 22:54:33 nightmorph Exp $ --> |
276 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-mips.xml,v 1.126 2012/01/15 09:55:35 swift Exp $ --> |
277 |
|
278 |
<book> |
279 |
<title>Gentoo Linux/MIPS Handbook</title> |
280 |
@@ -135,8 +135,8 @@ |
281 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
282 |
<license/> |
283 |
|
284 |
-<version>10.0</version> |
285 |
-<date>2010-07-27</date> |
286 |
+<version>11.0</version> |
287 |
+<date>2012-01-15</date> |
288 |
|
289 |
<part> |
290 |
<title>Installing Gentoo</title> |
291 |
@@ -269,6 +269,11 @@ |
292 |
<title>Diverting from the Official Tree</title> |
293 |
<include href="hb-portage-diverttree.xml"/> |
294 |
</chapter> |
295 |
+ |
296 |
+<chapter> |
297 |
+<title>Advanced Portage Features</title> |
298 |
+ <include href="hb-portage-advanced.xml" /> |
299 |
+</chapter> |
300 |
</part> |
301 |
|
302 |
<part> |
303 |
|
304 |
|
305 |
|
306 |
1.160 xml/htdocs/doc/en/handbook/handbook-ppc.xml |
307 |
|
308 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc.xml?rev=1.160&view=markup |
309 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc.xml?rev=1.160&content-type=text/plain |
310 |
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc.xml?r1=1.159&r2=1.160 |
311 |
|
312 |
Index: handbook-ppc.xml |
313 |
=================================================================== |
314 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc.xml,v |
315 |
retrieving revision 1.159 |
316 |
retrieving revision 1.160 |
317 |
diff -u -r1.159 -r1.160 |
318 |
--- handbook-ppc.xml 21 Jul 2010 01:28:29 -0000 1.159 |
319 |
+++ handbook-ppc.xml 15 Jan 2012 09:55:35 -0000 1.160 |
320 |
@@ -1,7 +1,7 @@ |
321 |
<?xml version='1.0' encoding='UTF-8'?> |
322 |
<!DOCTYPE book SYSTEM "/dtd/book.dtd"> |
323 |
|
324 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc.xml,v 1.159 2010/07/21 01:28:29 nightmorph Exp $ --> |
325 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc.xml,v 1.160 2012/01/15 09:55:35 swift Exp $ --> |
326 |
|
327 |
<book> |
328 |
<title>Gentoo Linux PPC Handbook</title> |
329 |
@@ -145,8 +145,8 @@ |
330 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
331 |
<license/> |
332 |
|
333 |
-<version>10.1</version> |
334 |
-<date>2010-07-20</date> |
335 |
+<version>11.0</version> |
336 |
+<date>2012-01-15</date> |
337 |
|
338 |
<part> |
339 |
<title>Installing Gentoo</title> |
340 |
@@ -279,6 +279,11 @@ |
341 |
<title>Diverting from the Official Tree</title> |
342 |
<include href="hb-portage-diverttree.xml"/> |
343 |
</chapter> |
344 |
+ |
345 |
+<chapter> |
346 |
+<title>Advanced Portage Features</title> |
347 |
+ <include href="hb-portage-advanced.xml" /> |
348 |
+</chapter> |
349 |
</part> |
350 |
|
351 |
<part> |
352 |
|
353 |
|
354 |
|
355 |
1.80 xml/htdocs/doc/en/handbook/handbook-ppc64.xml |
356 |
|
357 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc64.xml?rev=1.80&view=markup |
358 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc64.xml?rev=1.80&content-type=text/plain |
359 |
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc64.xml?r1=1.79&r2=1.80 |
360 |
|
361 |
Index: handbook-ppc64.xml |
362 |
=================================================================== |
363 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc64.xml,v |
364 |
retrieving revision 1.79 |
365 |
retrieving revision 1.80 |
366 |
diff -u -r1.79 -r1.80 |
367 |
--- handbook-ppc64.xml 21 Jul 2010 01:55:53 -0000 1.79 |
368 |
+++ handbook-ppc64.xml 15 Jan 2012 09:55:35 -0000 1.80 |
369 |
@@ -1,7 +1,7 @@ |
370 |
<?xml version='1.0' encoding='UTF-8'?> |
371 |
<!DOCTYPE book SYSTEM "/dtd/book.dtd"> |
372 |
|
373 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc64.xml,v 1.79 2010/07/21 01:55:53 nightmorph Exp $ --> |
374 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc64.xml,v 1.80 2012/01/15 09:55:35 swift Exp $ --> |
375 |
|
376 |
<book> |
377 |
<title>Gentoo Linux PPC64 Handbook</title> |
378 |
@@ -137,8 +137,8 @@ |
379 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
380 |
<license/> |
381 |
|
382 |
-<version>10.0</version> |
383 |
-<date>2010-07-20</date> |
384 |
+<version>11.0</version> |
385 |
+<date>2012-01-15</date> |
386 |
|
387 |
<part> |
388 |
<title>Installing Gentoo</title> |
389 |
@@ -272,6 +272,11 @@ |
390 |
<title>Diverting from the Official Tree</title> |
391 |
<include href="hb-portage-diverttree.xml"/> |
392 |
</chapter> |
393 |
+ |
394 |
+<chapter> |
395 |
+<title>Advanced Portage Features</title> |
396 |
+ <include href="hb-portage-advanced.xml" /> |
397 |
+</chapter> |
398 |
</part> |
399 |
|
400 |
<part> |
401 |
|
402 |
|
403 |
|
404 |
1.142 xml/htdocs/doc/en/handbook/handbook-sparc.xml |
405 |
|
406 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-sparc.xml?rev=1.142&view=markup |
407 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-sparc.xml?rev=1.142&content-type=text/plain |
408 |
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-sparc.xml?r1=1.141&r2=1.142 |
409 |
|
410 |
Index: handbook-sparc.xml |
411 |
=================================================================== |
412 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-sparc.xml,v |
413 |
retrieving revision 1.141 |
414 |
retrieving revision 1.142 |
415 |
diff -u -r1.141 -r1.142 |
416 |
--- handbook-sparc.xml 20 Jul 2010 08:29:37 -0000 1.141 |
417 |
+++ handbook-sparc.xml 15 Jan 2012 09:55:35 -0000 1.142 |
418 |
@@ -1,6 +1,6 @@ |
419 |
<?xml version='1.0' encoding='UTF-8'?> |
420 |
<!DOCTYPE book SYSTEM "/dtd/book.dtd"> |
421 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-sparc.xml,v 1.141 2010/07/20 08:29:37 nightmorph Exp $ --> |
422 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-sparc.xml,v 1.142 2012/01/15 09:55:35 swift Exp $ --> |
423 |
|
424 |
<book> |
425 |
<title>Gentoo Linux SPARC Handbook</title> |
426 |
@@ -136,8 +136,8 @@ |
427 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
428 |
<license/> |
429 |
|
430 |
-<version>10.0</version> |
431 |
-<date>2010-07-20</date> |
432 |
+<version>11.0</version> |
433 |
+<date>2012-01-15</date> |
434 |
|
435 |
<part> |
436 |
<title>Installing Gentoo</title> |
437 |
@@ -288,6 +288,11 @@ |
438 |
<title>Diverting from the Official Tree</title> |
439 |
<include href="hb-portage-diverttree.xml"/> |
440 |
</chapter> |
441 |
+ |
442 |
+<chapter> |
443 |
+<title>Advanced Portage Features</title> |
444 |
+ <include href="hb-portage-advanced.xml" /> |
445 |
+</chapter> |
446 |
</part> |
447 |
|
448 |
<part> |
449 |
|
450 |
|
451 |
|
452 |
1.175 xml/htdocs/doc/en/handbook/handbook-x86.xml |
453 |
|
454 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-x86.xml?rev=1.175&view=markup |
455 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-x86.xml?rev=1.175&content-type=text/plain |
456 |
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-x86.xml?r1=1.174&r2=1.175 |
457 |
|
458 |
Index: handbook-x86.xml |
459 |
=================================================================== |
460 |
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-x86.xml,v |
461 |
retrieving revision 1.174 |
462 |
retrieving revision 1.175 |
463 |
diff -u -r1.174 -r1.175 |
464 |
--- handbook-x86.xml 20 Jul 2010 02:05:22 -0000 1.174 |
465 |
+++ handbook-x86.xml 15 Jan 2012 09:55:35 -0000 1.175 |
466 |
@@ -1,7 +1,7 @@ |
467 |
<?xml version='1.0' encoding='UTF-8'?> |
468 |
<!DOCTYPE book SYSTEM "/dtd/book.dtd"> |
469 |
|
470 |
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-x86.xml,v 1.174 2010/07/20 02:05:22 nightmorph Exp $ --> |
471 |
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-x86.xml,v 1.175 2012/01/15 09:55:35 swift Exp $ --> |
472 |
|
473 |
<book> |
474 |
<title>Gentoo Linux x86 Handbook</title> |
475 |
@@ -141,8 +141,8 @@ |
476 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
477 |
<license/> |
478 |
|
479 |
-<version>10.2</version> |
480 |
-<date>2010-07-19</date> |
481 |
+<version>11.0</version> |
482 |
+<date>2012-01-15</date> |
483 |
|
484 |
<part> |
485 |
<title>Installing Gentoo</title> |
486 |
@@ -280,6 +280,11 @@ |
487 |
<title>Diverting from the Official Tree</title> |
488 |
<include href="hb-portage-diverttree.xml"/> |
489 |
</chapter> |
490 |
+ |
491 |
+<chapter> |
492 |
+<title>Advanced Portage Features</title> |
493 |
+ <include href="hb-portage-advanced.xml" /> |
494 |
+</chapter> |
495 |
</part> |
496 |
|
497 |
<part> |
498 |
|
499 |
|
500 |
|
501 |
1.1 xml/htdocs/doc/en/handbook/hb-portage-advanced.xml |
502 |
|
503 |
file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-portage-advanced.xml?rev=1.1&view=markup |
504 |
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-portage-advanced.xml?rev=1.1&content-type=text/plain |
505 |
|
506 |
Index: hb-portage-advanced.xml |
507 |
=================================================================== |
508 |
<?xml version='1.0' encoding='UTF-8'?> |
509 |
<!DOCTYPE sections SYSTEM "/dtd/book.dtd"> |
510 |
|
511 |
<!-- The content of this document is licensed under the CC-BY-SA license --> |
512 |
<!-- See http://creativecommons.org/licenses/by-sa/2.5 --> |
513 |
|
514 |
<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-portage-advanced.xml,v 1.1 2012/01/15 09:55:35 swift Exp $ --> |
515 |
|
516 |
<sections> |
517 |
|
518 |
<abstract> |
519 |
As times goes by, Portage evolves and matures further and further. Additional |
520 |
features are continuously being put in - many of these are only of use by more |
521 |
advanced users. This chapter will go into more detail of these specific |
522 |
features. |
523 |
</abstract> |
524 |
|
525 |
<version>1</version> |
526 |
<date>2012-01-15</date> |
527 |
|
528 |
<section> |
529 |
<title>Introduction</title> |
530 |
<body> |
531 |
|
532 |
<p> |
533 |
For most users, the information received thus far is sufficient for all their |
534 |
Linux operations. But Portage is capable of much more; many of its features are |
535 |
for advanced users or only applicable in specific corner cases. Still, that |
536 |
would not be an excuse not to document them. |
537 |
</p> |
538 |
|
539 |
<p> |
540 |
Of course, with lots of flexibility comes a huge list of potential cases. It |
541 |
will not be possible to document them all here. Instead, we hope to focus on |
542 |
some generic issues which you can then bend to fit your own needs. If you have |
543 |
need for more specific tweaks and tips, you might find them on the <uri |
544 |
link="https://wiki.gentoo.org">Gentoo WiKi</uri> instead. |
545 |
</p> |
546 |
|
547 |
<p> |
548 |
Most, if not all of these additional features can be easily found by digging |
549 |
through the manual pages that portage provides: |
550 |
</p> |
551 |
|
552 |
<pre caption="Reading up on portage man pages"> |
553 |
$ <i>man portage</i> |
554 |
$ <i>man make.conf</i> |
555 |
</pre> |
556 |
|
557 |
<p> |
558 |
Finally, know that these are advanced features which, if not worked with |
559 |
correctly, can make debugging and troubleshooting very difficult. Make sure you |
560 |
mention these if you think you hit a bug and want to open a bugreport. |
561 |
</p> |
562 |
|
563 |
</body> |
564 |
</section> |
565 |
|
566 |
<section> |
567 |
<title>Per-Package Environment Variables</title> |
568 |
<subsection> |
569 |
<title>Using /etc/portage/env</title> |
570 |
<body> |
571 |
|
572 |
<p> |
573 |
By default, package builds will use the environment variables defined in |
574 |
<path>/etc/make.conf</path>, such as <c>CFLAGS</c>, <c>MAKEOPTS</c> and more. In |
575 |
some cases though, you might want to provide different variables for specific |
576 |
packages. To do so, Portage supports the use of <path>/etc/portage/env</path> |
577 |
and <path>/etc/portage/package.env</path>. |
578 |
</p> |
579 |
|
580 |
<p> |
581 |
The <path>/etc/portage/package.env</path> file contains the list of packages for |
582 |
which you want deviating variables as well as a specific identifier that tells |
583 |
Portage which changes you want. The identifier name you pick yourself, Portage |
584 |
will look for the variables in the <path>/etc/portage/env/<identifier></path> |
585 |
file. |
586 |
</p> |
587 |
|
588 |
</body> |
589 |
</subsection> |
590 |
<subsection> |
591 |
<title>Example: Using debugging for specific packages</title> |
592 |
<body> |
593 |
|
594 |
<p> |
595 |
As an example, we enable debugging for the <path>media-video/mplayer</path> |
596 |
package. |
597 |
</p> |
598 |
|
599 |
<p> |
600 |
First of all, we set the debugging variables in a file called |
601 |
<path>/etc/portage/env/debug-cflags</path>. The name is arbitrarily chosen, but |
602 |
of course reflects the reason of the deviation to make it more obvious later why |
603 |
a deviation was put in. |
604 |
</p> |
605 |
|
606 |
<pre caption="/etc/portage/env/debug-cflags content"> |
607 |
CFLAGS="-O2 -ggdb -pipe" |
608 |
FEATURES="${FEATURES} nostrip" |
609 |
</pre> |
610 |
|
611 |
<p> |
612 |
Next, we tag the <path>media-video/mplayer</path> package to use this content: |
613 |
</p> |
614 |
|
615 |
<pre caption="/etc/portage/package.env content"> |
616 |
media-video/mplayer debug-cflags |
617 |
</pre> |
618 |
|
619 |
</body> |
620 |
</subsection> |
621 |
</section> |
622 |
|
623 |
<section> |
624 |
<title>Hooking In the Emerge Process</title> |
625 |
<subsection> |
626 |
<title>Using /etc/portage/bashrc and affiliated files</title> |
627 |
<body> |
628 |
|
629 |
<p> |
630 |
When Portage works with ebuilds, it uses a bash environment in which it calls |
631 |
the various build functions (like src_prepare, src_configure, src_postinst, |
632 |
etc.). But Portage also allows you to set up a bash environment yourself. |
633 |
</p> |
634 |
|
635 |
<p> |
636 |
The advantage of using your own bash environment is that you can hook in the |
637 |
emerge process during each step it performs. This can be done for every emerge |
638 |
(through <path>/etc/portage/bashrc</path>) or by using per-package environments |
639 |
(through <path>/etc/portage/env</path> as discussed earlier). |
640 |
</p> |
641 |
|
642 |
<p> |
643 |
To hook in the process, the bash environment can listen to the variables |
644 |
<c>EBUILD_PHASE</c>, <c>CATEGORY</c> as well as the variables that are always |
645 |
available during ebuild development (such as <c>P</c>, <c>PF</c>, ...). Based on |
646 |
the values of these variables, you can then execute additional steps. |
647 |
</p> |
648 |
|
649 |
</body> |
650 |
</subsection> |
651 |
<subsection> |
652 |
<title>Example: Updating File Databases</title> |
653 |
<body> |
654 |
|
655 |
<p> |
656 |
In this example, we'll use <path>/etc/portage/bashrc</path> to call some file |
657 |
database applications to ensure their databases are up to date with the system. |
658 |
The applications used in the example are <c>aide</c> (an intrusion detection |
659 |
tool) and <c>updatedb</c> (to use with <c>locate</c>), but these are meant as |
660 |
examples. Do not consider this as a HOWTO for AIDE ;-) |
661 |
</p> |
662 |
|
663 |
<p> |
664 |
To use <path>/etc/portage/bashrc</path> for this case, we need to "hook" in the |
665 |
<c>postrm</c> (after removal of files) and <c>postinst</c> (after installation |
666 |
of files) functions, because that is when the files on the file system have been |
667 |
changed. |
668 |
</p> |
669 |
|
670 |
<pre caption="Example /etc/portage/bashrc"> |
671 |
if [ "${EBUILD_PHASE}" == "postinst"] || [ "${EBUILD_PHASE}" == "postrm" ]; |
672 |
then |
673 |
echo ":: Calling aide --update to update its database"; |
674 |
aide --update; |
675 |
echo ":: Calling updatedb to update its database"; |
676 |
updatedb; |
677 |
fi |
678 |
</pre> |
679 |
|
680 |
</body> |
681 |
</subsection> |
682 |
</section> |
683 |
|
684 |
<section> |
685 |
<title>Executing Tasks After --sync</title> |
686 |
<subsection> |
687 |
<title>The /etc/portage/postsync.d location</title> |
688 |
<body> |
689 |
|
690 |
<p> |
691 |
Until now we've talked about hooking into the ebuild processes. However, Portage |
692 |
also has another important function: updating the Portage tree. In order to run |
693 |
tasks after updating the Portage tree, put a script inside |
694 |
<path>/etc/portage/postsync.d</path> and make sure it is marked as executable. |
695 |
</p> |
696 |
|
697 |
</body> |
698 |
</subsection> |
699 |
<subsection> |
700 |
<title>Example: Running eix-update</title> |
701 |
<body> |
702 |
|
703 |
<p> |
704 |
If you didn't use <c>eix-sync</c> to update the tree, you can still have its |
705 |
database updated after running <c>emerge --sync</c> (or <c>emerge-webrsync</c>) |
706 |
by putting a symlink to <path>/usr/bin/eix</path> called <path>eix-update</path> |
707 |
in <path>/etc/portage/postsync.d</path>. |
708 |
</p> |
709 |
|
710 |
<pre caption="Running eix-update after a sync operation"> |
711 |
# <i>ln -s /usr/bin/eix /etc/portage/postsync.d/eix-update</i> |
712 |
</pre> |
713 |
|
714 |
<note> |
715 |
If you rather use a different name, you will need to make a script that calls |
716 |
<c>/usr/bin/eix-update</c> instead. The <c>eix</c> binary looks at how it has |
717 |
been called to find out which function it has to execute. If you put in a |
718 |
symlink to <c>eix</c> that isn't called <c>eix-update</c>, it will not run |
719 |
correctly. |
720 |
</note> |
721 |
|
722 |
</body> |
723 |
</subsection> |
724 |
</section> |
725 |
|
726 |
<section> |
727 |
<title>Overriding Profile Settings</title> |
728 |
<subsection> |
729 |
<title>The /etc/portage/profile location</title> |
730 |
<body> |
731 |
|
732 |
<p> |
733 |
By default, Gentoo uses the settings contained in the profile pointed to by |
734 |
<path>/etc/make.profile</path> (a symbolic link to the right profile directory). |
735 |
These profiles define both specific settings as well as inherit settings from |
736 |
other profiles (through their <path>parent</path> file). |
737 |
</p> |
738 |
|
739 |
<p> |
740 |
By using <path>/etc/portage/profile</path>, you can override profile settings |
741 |
such as <path>packages</path> (what packages are considered to be part of the |
742 |
system set), <path>virtuals</path> (default packages when pulling in a virtual) |
743 |
and more. |
744 |
</p> |
745 |
|
746 |
</body> |
747 |
</subsection> |
748 |
<subsection> |
749 |
<title>Example: Adding nfs-utils to the System Set</title> |
750 |
<body> |
751 |
|
752 |
<p> |
753 |
If you use NFS-based file systems for rather critical file systems, you might |
754 |
want to have <path>net-fs/nfs-utils</path> "protected" as a system package, |
755 |
causing Portage to heavily warn you if it would be deleted. |
756 |
</p> |
757 |
|
758 |
<p> |
759 |
To accomplish that, we add the package to |
760 |
<path>/etc/portage/profile/packages</path>, prepended with a <c>*</c>: |
761 |
</p> |
762 |
|
763 |
<pre caption="/etc/portage/profile/packages content"> |
764 |
*net-fs/nfs-utils |
765 |
</pre> |
766 |
|
767 |
</body> |
768 |
</subsection> |
769 |
</section> |
770 |
|
771 |
<section> |
772 |
<title>Applying Non-Standard Patches</title> |
773 |
<subsection> |
774 |
<title>Using epatch_user</title> |
775 |
<body> |
776 |
|
777 |
<p> |
778 |
To manage several ebuilds in a similar manner, ebuild developers use |
779 |
<e>eclasses</e> (sort-of shell libraries) that define commonly used functions. |
780 |
One of these eclasses is <path>eutils.eclass</path> which offers an interesting |
781 |
function called <c>epatch_user</c>. |
782 |
</p> |
783 |
|
784 |
<p> |
785 |
The <c>epatch_user</c> function applies source code patches that are found in |
786 |
<path>/etc/portage/patches/<category>/<package>[-<version>[-<revision>]]</path>, |
787 |
whatever directory is found first. Sadly, not all ebuilds automatically call |
788 |
this function so just putting your patch in this location might not always work. |
789 |
</p> |
790 |
|
791 |
<p> |
792 |
Luckily, with the information provided above, you can call this function by |
793 |
hooking into, for instance, the <c>prepare</c> phase. The function can be called |
794 |
as many times as you like - it will only apply the patches once. |
795 |
</p> |
796 |
|
797 |
</body> |
798 |
</subsection> |
799 |
<subsection> |
800 |
<title>Example: Applying Patches to Firefox</title> |
801 |
<body> |
802 |
|
803 |
<p> |
804 |
The <path>www-client/firefox</path> package is one of the few that already call |
805 |
<c>epatch_user</c> from within the ebuild, so you do not need to override |
806 |
anything specific. |
807 |
</p> |
808 |
|
809 |
<p> |
810 |
If you need to patch firefox (for instance because a developer asked you to to |
811 |
support you in a bug you reported), put the patch in |
812 |
<path>/etc/portage/patches/www-client/firefox</path> (probably best to use the |
813 |
full name, including version so that the patch does not interfere with later |
814 |
versions) and rebuild firefox. |
815 |
</p> |
816 |
|
817 |
</body> |
818 |
</subsection> |
819 |
</section> |
820 |
|
821 |
</sections> |