Gentoo Archives: gentoo-doc-cvs

From: "Joshua Saddler (nightmorph)" <nightmorph@g.o>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: handbook-ppc64.xml hb-install-ppc64-bootloader.xml hb-install-ppc64-disk.xml hb-install-ppc64-kernel.xml hb-install-ppc64-medium.xml
Date: Wed, 21 Jul 2010 01:55:58
Message-Id: 20100721015553.76C6C2CE15@corvid.gentoo.org
1 nightmorph 10/07/21 01:55:53
2
3 Modified: handbook-ppc64.xml hb-install-ppc64-bootloader.xml
4 hb-install-ppc64-disk.xml
5 hb-install-ppc64-kernel.xml
6 hb-install-ppc64-medium.xml
7 Log:
8 Update the PPC64 handbook for the autobuilds. Major version bump for this release. Fixes bug 260403, bug 292726, and bug 234310.
9
10 Revision Changes Path
11 1.79 xml/htdocs/doc/en/handbook/handbook-ppc64.xml
12
13 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc64.xml?rev=1.79&view=markup
14 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc64.xml?rev=1.79&content-type=text/plain
15 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc64.xml?r1=1.78&r2=1.79
16
17 Index: handbook-ppc64.xml
18 ===================================================================
19 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc64.xml,v
20 retrieving revision 1.78
21 retrieving revision 1.79
22 diff -u -r1.78 -r1.79
23 --- handbook-ppc64.xml 6 Jul 2008 08:00:30 -0000 1.78
24 +++ handbook-ppc64.xml 21 Jul 2010 01:55:53 -0000 1.79
25 @@ -1,20 +1,22 @@
26 <?xml version='1.0' encoding='UTF-8'?>
27 <!DOCTYPE book SYSTEM "/dtd/book.dtd">
28
29 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc64.xml,v 1.78 2008/07/06 08:00:30 nightmorph Exp $ -->
30 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-ppc64.xml,v 1.79 2010/07/21 01:55:53 nightmorph Exp $ -->
31
32 <book>
33 <title>Gentoo Linux PPC64 Handbook</title>
34
35 <values>
36 <key id="arch">PPC64</key>
37 - <key id="kernel-version">2.6.24-r5</key>
38 - <key id="kernel-name">kernel-2.6.24-gentoo-r5</key>
39 - <key id="online-book">handbook-ppc64.xml</key>
40 - <key id="release-dir">releases/ppc/2008.0/</key>
41 - <key id="stage3">stage3-ppc64-32ul-2008.0.tar.bz2</key>
42 - <key id="profile">default/linux/ppc/ppc64/2008.0/32bit-userland</key>
43 + <key id="kernel-version">2.6.31-r10</key>
44 + <key id="kernel-name">kernel-2.6.31-gentoo-r10</key>
45 + <key id="min-cd-name">install-powerpc-minimal-&lt;release&gt;.iso</key>
46 + <key id="min-cd-size">105</key>
47 + <key id="release-dir">releases/ppc/autobuilds/</key>
48 + <key id="stage3">stage3-ppc64-32ul-&lt;release&gt;.tar.bz2</key>
49 + <key id="profile">default/linux/powerpc/ppc64/10.0/32bit-userland</key>
50 <key id="CFLAGS">-O2 -pipe</key>
51 + <key id="online-book">handbook-ppc64.xml</key>
52 </values>
53
54 <author title="Author">
55 @@ -135,8 +137,8 @@
56 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
57 <license/>
58
59 -<version>9.4</version>
60 -<date>2008-07-06</date>
61 +<version>10.0</version>
62 +<date>2010-07-20</date>
63
64 <part>
65 <title>Installing Gentoo</title>
66 @@ -151,11 +153,6 @@
67
68 <chapter>
69 <title>Choosing the Right Installation Medium</title>
70 -<abstract>
71 -You can install Gentoo in many ways. This chapter explains how to install Gentoo
72 -using the minimal Installation CD although installation through the Universal
73 -Installation CD is possible as well.
74 -</abstract>
75 <include href="hb-install-ppc64-medium.xml"/>
76 </chapter>
77
78 @@ -166,10 +163,6 @@
79
80 <chapter>
81 <title>Preparing the Disks</title>
82 -<abstract>
83 -To be able to install Gentoo, you must create the necessary partitions.
84 -This chapter describes how to partition a disk for future usage.
85 -</abstract>
86 <include href="hb-install-ppc64-disk.xml"/>
87 </chapter>
88
89 @@ -185,10 +178,6 @@
90
91 <chapter>
92 <title>Configuring the Kernel</title>
93 -<abstract>
94 -The Linux kernel is the core of every distribution. This chapter
95 -explains how to configure your kernel.
96 -</abstract>
97 <include href="hb-install-ppc64-kernel.xml"/>
98 </chapter>
99
100 @@ -204,12 +193,6 @@
101
102 <chapter>
103 <title>Configuring the Bootloader</title>
104 -<abstract>
105 -Several bootloaders exist. Each one of them has its own way of
106 -configuration. In this chapter we'll describe all possibilities for you
107 -and step you through the process of configuring a bootloader to your
108 -needs.
109 -</abstract>
110 <include href="hb-install-ppc64-bootloader.xml"/>
111 </chapter>
112
113
114
115
116 1.30 xml/htdocs/doc/en/handbook/hb-install-ppc64-bootloader.xml
117
118 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-bootloader.xml?rev=1.30&view=markup
119 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-bootloader.xml?rev=1.30&content-type=text/plain
120 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-bootloader.xml?r1=1.29&r2=1.30
121
122 Index: hb-install-ppc64-bootloader.xml
123 ===================================================================
124 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-bootloader.xml,v
125 retrieving revision 1.29
126 retrieving revision 1.30
127 diff -u -r1.29 -r1.30
128 --- hb-install-ppc64-bootloader.xml 2 May 2008 08:04:23 -0000 1.29
129 +++ hb-install-ppc64-bootloader.xml 21 Jul 2010 01:55:53 -0000 1.30
130 @@ -4,12 +4,19 @@
131 <!-- The content of this document is licensed under the CC-BY-SA license -->
132 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
133
134 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-bootloader.xml,v 1.29 2008/05/02 08:04:23 nightmorph Exp $ -->
135 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-bootloader.xml,v 1.30 2010/07/21 01:55:53 nightmorph Exp $ -->
136
137 <sections>
138
139 -<version>9.1</version>
140 -<date>2008-05-02</date>
141 +<abstract>
142 +Several bootloaders exist. Each one of them has its own way of
143 +configuration. In this chapter we'll describe all possibilities for you
144 +and step you through the process of configuring a bootloader to your
145 +needs.
146 +</abstract>
147 +
148 +<version>10.0</version>
149 +<date>2010-07-20</date>
150
151 <section>
152 <title>Making your Choice</title>
153 @@ -41,7 +48,7 @@
154 <impo>
155 If you are using a 64-bit userland, you must use the <c>yaboot-static</c>
156 package because yaboot cannot be compiled as a 64-bit application. The 32-bit
157 -userlands should use the regular yaboot package.
158 +userlands should use the regular <c>yaboot</c> package.
159 </impo>
160
161 <p>
162 @@ -175,7 +182,7 @@
163
164 <comment>#################
165 ## This section can be duplicated if you have more than one kernel or set of
166 -## boot options - replace <keyval id="kernel-name"/> with your kernel-version
167 +## boot options - replace <keyval id="kernel-name"/> with your kernel
168 #################</comment>
169 image=/boot/<keyval id="kernel-name"/>
170 label=Linux
171 @@ -216,8 +223,8 @@
172 <body>
173
174 <p>
175 -On IBM hardware you cannot run yabootconfig or ybin. You must proceed with the
176 -following steps:
177 +On IBM hardware you cannot run <c>yabootconfig</c> or <c>ybin</c>. You must
178 +proceed with the following steps:
179 </p>
180
181 <ul>
182
183
184
185 1.35 xml/htdocs/doc/en/handbook/hb-install-ppc64-disk.xml
186
187 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-disk.xml?rev=1.35&view=markup
188 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-disk.xml?rev=1.35&content-type=text/plain
189 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-disk.xml?r1=1.34&r2=1.35
190
191 Index: hb-install-ppc64-disk.xml
192 ===================================================================
193 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-disk.xml,v
194 retrieving revision 1.34
195 retrieving revision 1.35
196 diff -u -r1.34 -r1.35
197 --- hb-install-ppc64-disk.xml 26 Jan 2009 08:04:26 -0000 1.34
198 +++ hb-install-ppc64-disk.xml 21 Jul 2010 01:55:53 -0000 1.35
199 @@ -4,12 +4,17 @@
200 <!-- The content of this document is licensed under the CC-BY-SA license -->
201 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
202
203 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-disk.xml,v 1.34 2009/01/26 08:04:26 nightmorph Exp $ -->
204 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-disk.xml,v 1.35 2010/07/21 01:55:53 nightmorph Exp $ -->
205
206 <sections>
207
208 -<version>9.0</version>
209 -<date>2008-04-01</date>
210 +<abstract>
211 +To be able to install Gentoo, you must create the necessary partitions.
212 +This chapter describes how to partition a disk for future usage.
213 +</abstract>
214 +
215 +<version>10.0</version>
216 +<date>2010-07-20</date>
217
218 <section>
219 <title>Introduction to Block Devices</title>
220 @@ -308,12 +313,12 @@
221 </pre>
222
223 <p>
224 -Don't worry, you can create a new empty dos partition table by pressing
225 +Don't worry, you can create a new empty DOS partition table by pressing
226 <c>o</c>.
227 </p>
228
229 <warn>
230 -This will destroy any installed AIX version
231 +This will destroy any installed AIX version!
232 </warn>
233
234 <p>
235 @@ -321,7 +326,7 @@
236 </p>
237
238 <pre caption="An example partition configuration">
239 -Command (m for help): p
240 +Command (m for help): <i>p</i>
241
242 Disk /dev/sda: 30.7 GB, 30750031872 bytes
243 141 heads, 63 sectors/track, 6761 cylinders
244 @@ -359,9 +364,8 @@
245 </p>
246
247 <note>
248 -If you don't want to delete all partitions just delete those you
249 -want to delete. At this point the author recommends a backup of your
250 -data to avoid the lose of it.
251 +If you don't want to delete all partitions just delete those you want to delete.
252 +At this point you should create a backup of your data to avoid losing it.
253 </note>
254
255 <pre caption="Deleting a partition">
256 @@ -373,7 +377,7 @@
257 The partition has been scheduled for deletion. It will no longer show up
258 if you type <c>p</c>, but it will not be erased until your changes have
259 been saved. If you made a mistake and want to abort without saving your
260 -changes, type <c>q</c> immediately and hit enter and your partition will
261 +changes, type <c>q</c> immediately and hit Enter and your partition will
262 not be deleted.
263 </p>
264
265 @@ -412,7 +416,7 @@
266 partition, then <c>p</c> to select a primary partition, followed by
267 <c>1</c> to select the first primary partition. When prompted for the
268 first cylinder, hit enter. When prompted for the last cylinder, type
269 -<c>+7M</c> to create a partition 7 Mbyte in size. After you've done
270 +<c>+7M</c> to create a partition 7 MB in size. After you've done
271 this, type <c>t</c> to set the partition type, <c>1</c> to select the
272 partition you just created and then type in <c>41</c> to set the
273 partition type to "PPC PReP Boot". Finally, you'll need to mark the PReP
274 @@ -420,7 +424,7 @@
275 </p>
276
277 <note>
278 -The PReP partition has to be smaller than 8 MByte!
279 +The PReP partition has to be smaller than 8 MB!
280 </note>
281
282 <pre caption="Creating the PReP boot partition">
283 @@ -520,7 +524,7 @@
284 </p>
285
286 <pre caption="Partition listing after creating the root partition">
287 -Command (m for help): p
288 +Command (m for help): <i>p</i>
289
290 Disk /dev/sda: 30.7 GB, 30750031872 bytes
291 141 heads, 63 sectors/track, 6761 cylinders
292
293
294
295 1.37 xml/htdocs/doc/en/handbook/hb-install-ppc64-kernel.xml
296
297 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-kernel.xml?rev=1.37&view=markup
298 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-kernel.xml?rev=1.37&content-type=text/plain
299 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-kernel.xml?r1=1.36&r2=1.37
300
301 Index: hb-install-ppc64-kernel.xml
302 ===================================================================
303 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-kernel.xml,v
304 retrieving revision 1.36
305 retrieving revision 1.37
306 diff -u -r1.36 -r1.37
307 --- hb-install-ppc64-kernel.xml 5 Aug 2009 15:25:23 -0000 1.36
308 +++ hb-install-ppc64-kernel.xml 21 Jul 2010 01:55:53 -0000 1.37
309 @@ -4,12 +4,17 @@
310 <!-- The content of this document is licensed under the CC-BY-SA license -->
311 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
312
313 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-kernel.xml,v 1.36 2009/08/05 15:25:23 nightmorph Exp $ -->
314 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-kernel.xml,v 1.37 2010/07/21 01:55:53 nightmorph Exp $ -->
315
316 <sections>
317
318 -<version>9.1</version>
319 -<date>2009-08-05</date>
320 +<abstract>
321 +The Linux kernel is the core of every distribution. This chapter
322 +explains how to configure your kernel.
323 +</abstract>
324 +
325 +<version>10.0</version>
326 +<date>2010-07-20</date>
327
328 <section>
329 <title>Timezone</title>
330 @@ -39,15 +44,20 @@
331 <body>
332
333 <p>
334 -The core around which all distributions are built is the Linux kernel.
335 -It is the layer between the user programs and your system hardware.
336 -Gentoo provides its users several possible kernel sources. A full
337 -listing with description is available at the <uri
338 -link="/doc/en/gentoo-kernel.xml">Gentoo Kernel Guide</uri>.
339 +The core around which all distributions are built is the Linux kernel. It is the
340 +layer between the user programs and your system hardware. Gentoo provides its
341 +users several possible kernel sources. A full listing with description is
342 +available at the <uri link="/doc/en/gentoo-kernel.xml">Gentoo Kernel
343 +Guide</uri>.
344 +</p>
345 +
346 +<p>
347 +For <keyval id="arch"/>-based systems we have <c>gentoo-sources</c>
348 +(kernel source patched for extra features).
349 </p>
350
351 <p>
352 -For PPC64 you should use <c>gentoo-sources</c>.
353 +Choose your kernel source and install it using <c>emerge</c>.
354 </p>
355
356 <pre caption="Installing a kernel source">
357 @@ -67,10 +77,10 @@
358 </pre>
359
360 <p>
361 -Now it is time to configure and compile your kernel source. There is the
362 -ability to use "genkernel" which would create a generic kernel like the
363 -ones used on the installation CDs, but it is not fully functional for PPC64 at
364 -the moment.
365 +Now it is time to configure and compile your kernel source. There is the ability
366 +to use <c>genkernel</c> which would create a generic kernel like the ones used
367 +on the installation CDs, but it is not fully functional for PPC64 at the
368 +moment.
369 </p>
370
371 <p>
372 @@ -114,9 +124,9 @@
373 </pre>
374
375 <p>
376 -You will be greeted with several configuration sections. We'll first
377 -list some options you must activate (otherwise Gentoo will not function,
378 -or not function properly without additional tweaks).
379 +You will be greeted with several configuration sections. We'll first list some
380 +options you must activate (otherwise Gentoo will not function, or not function
381 +properly without additional tweaks).
382 </p>
383
384 </body>
385 @@ -198,12 +208,11 @@
386
387 <p>
388 When the kernel has finished compiling, copy the kernel image to
389 -<path>/boot</path>. Remember to replace <path>&lt;kernel-version&lt;</path>
390 -with your actual kernel version:
391 +<path>/boot</path>.
392 </p>
393
394 <pre caption="Installing the kernel">
395 -(Apple/IBM) # <i>cp vmlinux /boot/&lt;kernel-version&gt;</i>
396 +(Apple/IBM) # <i>cp vmlinux /boot/<keyval id="kernel-name"/></i>
397 </pre>
398
399 <p>
400
401
402
403 1.42 xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml
404
405 file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml?rev=1.42&view=markup
406 plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml?rev=1.42&content-type=text/plain
407 diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml?r1=1.41&r2=1.42
408
409 Index: hb-install-ppc64-medium.xml
410 ===================================================================
411 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml,v
412 retrieving revision 1.41
413 retrieving revision 1.42
414 diff -u -r1.41 -r1.42
415 --- hb-install-ppc64-medium.xml 5 Aug 2009 15:25:23 -0000 1.41
416 +++ hb-install-ppc64-medium.xml 21 Jul 2010 01:55:53 -0000 1.42
417 @@ -4,12 +4,17 @@
418 <!-- The content of this document is licensed under the CC-BY-SA license -->
419 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
420
421 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml,v 1.41 2009/08/05 15:25:23 nightmorph Exp $ -->
422 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-medium.xml,v 1.42 2010/07/21 01:55:53 nightmorph Exp $ -->
423
424 <sections>
425
426 -<version>9.4</version>
427 -<date>2009-08-05</date>
428 +<abstract>
429 +You can install Gentoo in many ways. This chapter explains how to install
430 +Gentoo using the minimal Installation CD.
431 +</abstract>
432 +
433 +<version>10.0</version>
434 +<date>2010-07-20</date>
435
436 <section>
437 <title>Hardware Requirements</title>
438 @@ -78,12 +83,9 @@
439
440 <p>
441 All Installation CDs allow you to boot, set up networking, initialize your
442 -partitions and start installing Gentoo from the Internet. We currently provide
443 -two Installation CDs which are equally suitable to install Gentoo from, as long
444 -as you're planning on performing an Internet-based installation using the
445 -latest version of the available packages.
446 +partitions and start installing Gentoo from the Internet.
447 </p>
448 -
449 +<!--
450 <p>
451 If you wish to install Gentoo without a working Internet connection, please use
452 the installation instructions described in the <uri
453 @@ -111,20 +113,20 @@
454 To help you decide which Installation CD you need, we have written down the
455 major advantages and disadvantages of each Installation CD.
456 </p>
457 -
458 +-->
459 </body>
460 </subsection>
461 <subsection>
462 -<title>Gentoo's Minimal Installation CD</title>
463 +<title>Gentoo Minimal Installation CD</title>
464 <body>
465
466 <p>
467 -The Minimal Installation CD is called
468 -<c>install-ppc64-minimal-2008.0.iso</c> and takes up only 124 MB of
469 -diskspace. You can use this Installation CD to install Gentoo, but always with a
470 -working Internet connection only.
471 +The Minimal Installation CD is called <c><keyval id="min-cd-name"/></c> and
472 +takes up only <keyval id="min-cd-size"/> MB of diskspace. You can use this
473 +Installation CD to install Gentoo, but <e>only</e> with a working Internet
474 +connection.
475 </p>
476 -
477 +<!--
478 <table>
479 <tr>
480 <th>Minimal Installation CD</th>
481 @@ -173,7 +175,7 @@
482 <ti>Huge download</ti>
483 </tr>
484 </table>
485 -
486 +-->
487 </body>
488 </subsection>
489 <subsection>
490 @@ -181,16 +183,23 @@
491 <body>
492
493 <p>
494 -A stage3 tarball is an archive containing a minimal Gentoo environment, suitable
495 -to continue the Gentoo installation using the instructions in this manual.
496 -Previously, the Gentoo Handbook described the installation using one of three
497 -stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the
498 +A stage3 tarball is an archive containing a minimal Gentoo environment,
499 +suitable to continue the Gentoo installation using the instructions in this
500 +manual. Previously, the Gentoo Handbook described the installation using one of
501 +three stage tarballs. While Gentoo still offers stage1 and stage2 tarballs, the
502 official installation method uses the stage3 tarball. If you are interested in
503 performing a Gentoo installation using a stage1 or stage2 tarball, please read
504 the Gentoo FAQ on <uri link="/doc/en/faq.xml#stage12">How do I Install Gentoo
505 Using a Stage1 or Stage2 Tarball?</uri>
506 </p>
507
508 +<p>
509 +Stage3 tarballs can be downloaded from <path><keyval
510 +id="release-dir"/>current-stage3/</path> on any of the <uri
511 +link="/main/en/mirrors.xml">Official Gentoo Mirrors</uri> and are not provided
512 +on the LiveCD.
513 +</p>
514 +
515 </body>
516 </subsection>
517 <subsection>
518 @@ -198,11 +207,11 @@
519 <body>
520
521 <p>
522 -On PPC64, the kernel is 64-bit and the <e>userland</e> can be 32-bit or 64-bit. The
523 -userland is basically the applications you are running, such as
524 -<c>bash</c> or <c>mozilla-firefox</c>. They can be compiled and run in either
525 -64-bit or 32-bit modes. The Gentoo/PPC64 team provides both 32-bit and 64-bit
526 -userlands, so which one should you use?
527 +On PPC64, the kernel is 64-bit and the <e>userland</e> can be 32-bit or 64-bit.
528 +The userland is basically the applications you are running, such as <c>bash</c>
529 +or <c>firefox</c>. They can be compiled and run in either 64-bit or
530 +32-bit modes. The Gentoo/PPC64 team provides both 32-bit and 64-bit userlands,
531 +so which one should you use?
532 </p>
533
534 <p>
535 @@ -213,10 +222,10 @@
536
537 <p>
538 You really only need 64-bit applications when you need more memory than a 32-bit
539 -userland allows, or if you do a lot of 64-bit number crunching. If you run
540 -applications that require more than 4GB of memory or you run scientific
541 -applications, you should choose the 64-bit userland. Otherwise, choose the
542 -32-bit userland, as it is recommended by the Gentoo/PPC64 developers.
543 +userland allows, or if you do a lot of 64-bit number crunching. If you have 4GB
544 +or more of memory or you run scientific applications, you should choose the
545 +64-bit userland. Otherwise, choose the 32-bit userland, as it is recommended by
546 +the Gentoo/PPC64 developers.
547 </p>
548
549 <p>
550 @@ -230,12 +239,6 @@
551 their code is fixed, such as OpenOffice.
552 </p>
553
554 -<p>
555 -The Gentoo/PPC64 team provides stages and Package CDs for both 32-bit and 64-bit
556 -userlands, so no matter which one you choose, you'll be able to successfully
557 -install Gentoo and get a full system up and running with minimal fuss.
558 -</p>
559 -
560 </body>
561 </subsection>
562 </section>
563 @@ -253,10 +256,9 @@
564 </p>
565
566 <p>
567 -You can download any of the Installation CDs (and, if you want to, a Packages CD
568 -as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The
569 -Installation CDs are located in the <path><keyval
570 -id="release-dir"/>installcd</path> directory.
571 +You can download any of the Installation CDs from one of our <uri
572 +link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located in
573 +the <path><keyval id="release-dir"/>current-iso/</path> directory.
574 </p>
575
576 <p>
577 @@ -265,9 +267,9 @@
578 </p>
579
580 <p>
581 -In case you wonder if your downloaded file is corrupted or not, you can
582 -check its MD5 checksum and compare it with the MD5 checksum we provide (such as
583 -<path>install-ppc64-minimal-2008.0.iso.DIGESTS</path>). You can check the MD5
584 +In case you wonder if your downloaded file is corrupted or not, you can check
585 +its MD5 checksum and compare it with the MD5 checksum we provide (such as
586 +<path><keyval id="min-cd-name"/>.DIGESTS</path>). You can check the MD5
587 checksum with the <c>md5sum</c> tool under Linux/Unix or <uri
588 link="http://www.etree.org/md5com.html">md5sum</uri> for Windows.
589 </p>
590 @@ -279,15 +281,18 @@
591 </p>
592
593 <pre caption="Obtaining the public key">
594 -$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 17072058</i>
595 +$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 2D182910</i>
596 </pre>
597
598 <p>
599 Now verify the signature:
600 </p>
601
602 -<pre caption="Verify the cryptographic signature">
603 -$ <i>gpg --verify &lt;signature file&gt; &lt;downloaded iso&gt;</i>
604 +<pre caption="Verify the files">
605 +<comment>(Verify the cryptographic signature)</comment>
606 +$ <i>gpg --verify &lt;downloaded iso.DIGESTS.asc&gt;</i>
607 +<comment>(Verify the checksum)</comment>
608 +$ <i>sha1sum -c &lt;downloaded iso.DIGESTS.asc&gt;</i>
609 </pre>
610
611 <p>