Gentoo Archives: gentoo-doc-cvs

From: "Sven Vermeulen (swift)" <swift@g.o>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: handbook-alpha.xml handbook-amd64.xml handbook-arm.xml handbook-hppa.xml handbook-ia64.xml handbook-mips.xml handbook-ppc.xml handbook-ppc64.xml handbook-sparc.xml handbook-x86.xml hb-portage-advanced.xml
Date: Sun, 15 Jan 2012 09:55:47
Message-Id: 20120115095535.9761F2004B@flycatcher.gentoo.org
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/&lt;identifier&gt;</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/&lt;category&gt;/&lt;package&gt;[-&lt;version&gt;[-&lt;revision&gt;]]</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>