Gentoo Archives: gentoo-doc-cvs

From: Joseph Jezak <josejx@×××××××××××.org>
To: gentoo-doc-cvs@l.g.o
Subject: [gentoo-doc-cvs] cvs commit: hb-install-config.xml hb-install-ppc-bootloader.xml hb-install-ppc-disk.xml hb-install-ppc-kernel.xml hb-install-ppc-medium.xml hb-install-stage.xml
Date: Fri, 11 Aug 2006 16:32:20
Message-Id: 20060811163153.E1BBA645F7@smtp.gentoo.org
1 josejx 06/08/11 16:31:53
2
3 Modified: hb-install-config.xml hb-install-ppc-bootloader.xml
4 hb-install-ppc-disk.xml hb-install-ppc-kernel.xml
5 hb-install-ppc-medium.xml hb-install-stage.xml
6 Log:
7 PPC Handbook changes.
8
9 Revision Changes Path
10 1.2 xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-config.xml
11
12 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-config.xml?rev=1.2&view=markup
13 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-config.xml?rev=1.2&content-type=text/plain
14 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-config.xml?r1=1.1&r2=1.2
15
16 Index: hb-install-config.xml
17 ===================================================================
18 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-config.xml,v
19 retrieving revision 1.1
20 retrieving revision 1.2
21 diff -u -r1.1 -r1.2
22 --- hb-install-config.xml 9 Aug 2006 16:35:14 -0000 1.1
23 +++ hb-install-config.xml 11 Aug 2006 16:31:53 -0000 1.2
24 @@ -4,12 +4,12 @@
25 <!-- The content of this document is licensed under the CC-BY-SA license -->
26 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
27
28 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-config.xml,v 1.1 2006/08/09 16:35:14 fox2mike Exp $ -->
29 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-config.xml,v 1.2 2006/08/11 16:31:53 josejx Exp $ -->
30
31 <sections>
32
33 -<version>6.2</version>
34 -<date>2006-05-27</date>
35 +<version>6.3</version>
36 +<date>2006-08-11</date>
37
38 <section>
39 <title>Filesystem Information</title>
40 @@ -79,9 +79,10 @@
41
42 <p>
43 Let us take a look at how we write down the options for the <path>/boot</path>
44 -partition. This is just an example, so if your architecture doesn't require a
45 -<path>/boot</path> partition (such as Apple <b>PPC</b> machines), don't copy it
46 -verbatim.
47 +partition. If your architecture doesn't require a seperate <path>/boot</path>
48 +partition (such as Apple PowerPC machines) or you have elected not to create
49 +one, don't include a boot line in your fstab. The Apple Bootstrap partition
50 +is not a <path>/boot</path> partition.
51 </p>
52
53 <p>
54
55
56
57 1.2 xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-ppc-bootloader.xml
58
59 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-ppc-bootloader.xml?rev=1.2&view=markup
60 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-ppc-bootloader.xml?rev=1.2&content-type=text/plain
61 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-ppc-bootloader.xml?r1=1.1&r2=1.2
62
63 Index: hb-install-ppc-bootloader.xml
64 ===================================================================
65 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-ppc-bootloader.xml,v
66 retrieving revision 1.1
67 retrieving revision 1.2
68 diff -u -r1.1 -r1.2
69 --- hb-install-ppc-bootloader.xml 9 Aug 2006 16:35:14 -0000 1.1
70 +++ hb-install-ppc-bootloader.xml 11 Aug 2006 16:31:53 -0000 1.2
71 @@ -4,12 +4,12 @@
72 <!-- The content of this document is licensed under the CC-BY-SA license -->
73 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
74
75 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-ppc-bootloader.xml,v 1.1 2006/08/09 16:35:14 fox2mike Exp $ -->
76 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-ppc-bootloader.xml,v 1.2 2006/08/11 16:31:53 josejx Exp $ -->
77
78 <sections>
79
80 -<version>6.2</version>
81 -<date>2006-07-25</date>
82 +<version>6.3</version>
83 +<date>2006-08-11</date>
84
85 <section>
86 <title>Choosing a Bootloader</title>
87 @@ -78,13 +78,15 @@
88 <pre caption="Adding genkernel boot arguments to yaboot.conf">
89 <comment>###########################################################
90 ## This section can be duplicated if you have more than one
91 -## kernel or set of boot options - replace kernel-2.6.15
92 -## with the exact filename of your kernel.
93 +## kernel or set of boot options - replace kernel-name
94 +## and initrd-name with the exact filename of your kernel
95 +## and initrd image.
96 ###########################################################</comment>
97 -image=/boot/kernel-2.6.15
98 +image=/boot/kernel-name
99 label=Linux
100 root=/dev/ram0
101 partition=3
102 + initrd=/boot/initrd-name
103 append="real_root=/dev/hda3 init=/linuxrc"
104 <comment># You can add additional kernel arguments to append such as
105 # rootdelay=10 for a USB/Firewire Boot</comment>
106 @@ -179,7 +181,7 @@
107 ## For a dual-boot menu, add one or more of:
108 ## bsd=/dev/hdaX, macos=/dev/hdaY, macosx=/dev/hdaZ
109
110 -## our bootstrap partition:</comment>
111 +## The bootstrap partition:</comment>
112
113 boot=/dev/hda2
114
115 @@ -215,9 +217,9 @@
116
117 <comment>#################
118 ## This section can be duplicated if you have more than one kernel or set of
119 -## boot options - replace 2.6.9 with your kernel-version
120 +## boot options - replace kernel-name with your kernel-version
121 #################</comment>
122 -image=/boot/kernel-2.6.9
123 +image=/boot/kernel-name
124 label=Linux
125 root=/dev/hda3
126 partition=3
127 @@ -364,7 +366,7 @@
128 root = /dev/hda4
129 timeout = 30
130 default = gentoo
131 -image = /vmlinux-2.6.15
132 +image = /vmlinux <comment># This is your kernel</comment>
133 label = gentoo
134 </pre>
135
136 @@ -392,7 +394,7 @@
137 # <i>nvsetenv input-device kbd</i>
138 # <i>nvsetenv boot-device scsi/sd@1:0</i> <comment># For SCSI</comment>
139 # <i>nvsetenv boot-device ata/ata-disk@0:0</i> <comment># For ATA</comment>
140 -# <i>nvsetenv boot-file /boot/vmlinux-2.6.15 root=/dev/hda4</i> <comment>First item is the path to the kernel, the second is the root partition. You may append any kernel options to the end of this line.</comment>
141 +# <i>nvsetenv boot-file /boot/vmlinux-2.6.17 root=/dev/hda4</i> <comment>First item is the path to the kernel, the second is the root partition. You may append any kernel options to the end of this line.</comment>
142 # <i>nvsetenv boot-command boot</i> <comment># Set this to bye for MacOS and boot for Linux</comment>
143 </pre>
144
145 @@ -453,8 +455,8 @@
146 </pre>
147
148 <p>
149 -Below you find a completed <path>/etc/bootmenu</path> config file. Alter it at
150 -will.
151 +Below is a complete <path>/etc/bootmenu</path> config file. The kernel-name
152 +and initrd-name should be replaced by your kernel and initrd image names.
153 </p>
154
155 <pre caption = "bootcreator config file">
156 @@ -478,12 +480,12 @@
157 ide:0 boot2.img ramdebug edebugflags="logkprintf"
158
159 [SECTION]
160 -Local HD -> Linux 2.6.15 (Normal)
161 -ide:0 linux-2.6.15 video=radeonfb:1024x768@70 root=/dev/hda3
162 +Local HD -> Linux (Normal)
163 +ide:0 kernel-name video=radeonfb:1024x768@70 root=/dev/hda3
164
165 [SECTION]
166 Local HD -> Genkernel (Normal)
167 -ide:0 kernelz-2.6.15 root=/dev/ram0 real_root=/dev/hda3 init=/linuxrc
168 +ide:0 kernel-name root=/dev/ram0 real_root=/dev/hda3 init=/linuxrc initrd=initrd-name
169 </pre>
170
171 <p>
172
173
174
175 1.2 xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-ppc-disk.xml
176
177 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-ppc-disk.xml?rev=1.2&view=markup
178 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-ppc-disk.xml?rev=1.2&content-type=text/plain
179 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-ppc-disk.xml?r1=1.1&r2=1.2
180
181 Index: hb-install-ppc-disk.xml
182 ===================================================================
183 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-ppc-disk.xml,v
184 retrieving revision 1.1
185 retrieving revision 1.2
186 diff -u -r1.1 -r1.2
187 --- hb-install-ppc-disk.xml 9 Aug 2006 16:35:14 -0000 1.1
188 +++ hb-install-ppc-disk.xml 11 Aug 2006 16:31:53 -0000 1.2
189 @@ -4,12 +4,12 @@
190 <!-- The content of this document is licensed under the CC-BY-SA license -->
191 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
192
193 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-ppc-disk.xml,v 1.1 2006/08/09 16:35:14 fox2mike Exp $ -->
194 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-ppc-disk.xml,v 1.2 2006/08/11 16:31:53 josejx Exp $ -->
195
196 <sections>
197
198 -<version>6.1</version>
199 -<date>2006-07-25</date>
200 +<version>6.2</version>
201 +<date>2006-08-11</date>
202
203 <section>
204 <title>Introduction to Block Devices</title>
205
206
207
208 1.2 xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-ppc-kernel.xml
209
210 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-ppc-kernel.xml?rev=1.2&view=markup
211 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-ppc-kernel.xml?rev=1.2&content-type=text/plain
212 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-ppc-kernel.xml?r1=1.1&r2=1.2
213
214 Index: hb-install-ppc-kernel.xml
215 ===================================================================
216 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-ppc-kernel.xml,v
217 retrieving revision 1.1
218 retrieving revision 1.2
219 diff -u -r1.1 -r1.2
220 --- hb-install-ppc-kernel.xml 9 Aug 2006 16:35:14 -0000 1.1
221 +++ hb-install-ppc-kernel.xml 11 Aug 2006 16:31:53 -0000 1.2
222 @@ -4,12 +4,12 @@
223 <!-- The content of this document is licensed under the CC-BY-SA license -->
224 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
225
226 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-ppc-kernel.xml,v 1.1 2006/08/09 16:35:14 fox2mike Exp $ -->
227 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-ppc-kernel.xml,v 1.2 2006/08/11 16:31:53 josejx Exp $ -->
228
229 <sections>
230
231 -<version>6.0</version>
232 -<date>2006-02-27</date>
233 +<version>6.1</version>
234 +<date>2006-08-11</date>
235
236 <section>
237 <title>Timezone</title>
238 @@ -156,8 +156,10 @@
239 <p>
240 Now go to <c>File Systems</c> and select support for the filesystems you use.
241 <e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
242 -able to mount your partitions. Also select <c>/proc file system</c> and
243 -<c>Virtual memory</c>.
244 +able to mount your partitions. Also select the <c>/proc file system</c> and
245 +<c>Virtual memory</c>. Make sure that you also enable support for Amiga
246 +partitions if you are using a Pegasos, or Macintosh partitions if you are using
247 +an Apple computer.
248 </p>
249
250 <pre caption="Selecting necessary file systems">
251 @@ -165,6 +167,9 @@
252 Pseudo Filesystems ---&gt;
253 [*] /proc file system support
254 [*] Virtual memory file system support (former shm fs)
255 + Partition Types ---&gt;
256 + [*] Amiga partition table support
257 + [*] Macintosh partition map support
258
259 <comment>(Select one or more of the following options as needed by your system)</comment>
260 &lt;*&gt; Reiserfs support
261 @@ -215,8 +220,8 @@
262 </p>
263
264 <pre caption="Ensure the Preemptible Kernel Option is Off">
265 -Platform options ---&gt;
266 - [ ] Preemptible Kernel
267 +Kernel options ---&gt;
268 + Preemption Model (No Forced Preemption (Server))
269 </pre>
270
271 <p>
272
273
274
275 1.2 xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-ppc-medium.xml
276
277 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-ppc-medium.xml?rev=1.2&view=markup
278 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-ppc-medium.xml?rev=1.2&content-type=text/plain
279 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-ppc-medium.xml?r1=1.1&r2=1.2
280
281 Index: hb-install-ppc-medium.xml
282 ===================================================================
283 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-ppc-medium.xml,v
284 retrieving revision 1.1
285 retrieving revision 1.2
286 diff -u -r1.1 -r1.2
287 --- hb-install-ppc-medium.xml 9 Aug 2006 16:35:14 -0000 1.1
288 +++ hb-install-ppc-medium.xml 11 Aug 2006 16:31:53 -0000 1.2
289 @@ -4,12 +4,12 @@
290 <!-- The content of this document is licensed under the CC-BY-SA license -->
291 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
292
293 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-ppc-medium.xml,v 1.1 2006/08/09 16:35:14 fox2mike Exp $ -->
294 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-ppc-medium.xml,v 1.2 2006/08/11 16:31:53 josejx Exp $ -->
295
296 <sections>
297
298 -<version>6.1</version>
299 -<date>2006-07-25</date>
300 +<version>6.2</version>
301 +<date>2006-08-11</date>
302
303 <section>
304 <title>Hardware Requirements</title>
305 @@ -241,7 +241,7 @@
306 </p>
307
308 <p>
309 -We provide one generic kernel, <e>ppc32</e>. This kernel is built with support
310 +We provide one generic kernel, <e>apple</e>. This kernel is built with support
311 for multiple CPUs, but it will boot on single processor machines as well.
312 </p>
313
314 @@ -290,13 +290,13 @@
315 </table>
316
317 <p>
318 -To use the above options, at the <e>boot:</e> prompt, type <e>ppc32</e> followed
319 +To use the above options, at the <e>boot:</e> prompt, type <e>apple</e> followed
320 by the desired option. In the example below, we'll force the kernel to use the
321 OpenFirmware framebuffer instead of the device specific driver.
322 </p>
323
324 <pre caption="Force the use of the OpenFirmware framebuffer">
325 -boot: <i>ppc32 video=ofonly</i>
326 +boot: <i>apple video=ofonly</i>
327 </pre>
328
329 <p>
330 @@ -341,14 +341,14 @@
331 archive into <c>Extensions Folder</c> and the BootX App Control Panel into
332 <c>Control Panels</c>, both of which are located in your MacOS System Folder.
333 Next, create a folder called "Linux Kernels" in your System folder and copy the
334 -<c>ppc32</c> kernel from the CD to this folder. Finally, copy <c>ppc32.igz</c>
335 +<c>apple</c> kernel from the CD to this folder. Finally, copy <c>apple.igz</c>
336 from the Installation CD <path>boot</path> folder into the MacOS
337 <c>System Folder</c>.
338 </p>
339
340 <p>
341 To prepare BootX, start the BootX App Control Panel. First select the Options
342 -dialog and check <c>Use Specified RAM Disk</c> and select <c>ppc32.igz</c> from
343 +dialog and check <c>Use Specified RAM Disk</c> and select <c>apple.igz</c> from
344 your System Folder. Continue back to the initial screen and ensure that the
345 ramdisk size is at least <c>32000</c>. Finally, set the kernel arguments as
346 shown below:
347
348
349
350 1.2 xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-stage.xml
351
352 file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-stage.xml?rev=1.2&view=markup
353 plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-stage.xml?rev=1.2&content-type=text/plain
354 diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-stage.xml?r1=1.1&r2=1.2
355
356 Index: hb-install-stage.xml
357 ===================================================================
358 RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-stage.xml,v
359 retrieving revision 1.1
360 retrieving revision 1.2
361 diff -u -r1.1 -r1.2
362 --- hb-install-stage.xml 9 Aug 2006 16:35:14 -0000 1.1
363 +++ hb-install-stage.xml 11 Aug 2006 16:31:53 -0000 1.2
364 @@ -4,7 +4,7 @@
365 <!-- The content of this document is licensed under the CC-BY-SA license -->
366 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
367
368 -<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-stage.xml,v 1.1 2006/08/09 16:35:14 fox2mike Exp $ -->
369 +<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.1/hb-install-stage.xml,v 1.2 2006/08/11 16:31:53 josejx Exp $ -->
370
371 <sections>
372
373 @@ -351,19 +351,18 @@
374 </p>
375
376 <p>
377 -We will not explain all possible optimization options. If you want to know
378 -them all, read the <uri link="http://gcc.gnu.org/onlinedocs/">GNU
379 +We cannot explain all possible optimization options here, but if you want to
380 +investigate them all, read the <uri link="http://gcc.gnu.org/onlinedocs/">GNU
381 Online Manual(s)</uri> or the <c>gcc</c> info page (<c>info gcc</c> -- only
382 -works on a working Linux system). The <path>make.conf.example</path> file
383 -itself also contains lots of examples and information; don't forget to read it
384 -too.
385 +works on a working Linux system). For common optimizations and architecture
386 +specific settings, please read <path>/etc/make.conf.example</path>. This
387 +file also contains lots of examples and information; don't forget to read it
388 +too.
389 </p>
390
391 <p>
392 -A first setting is the <c>-march=</c> flag, which specifies the name of the
393 -target architecture. Possible options are described in the
394 -<path>make.conf.example</path> file (as comments). For instance, for the x86
395 -Athlon XP architecture:
396 +As an example, on the x86 architecture, you will want to set the -march= flag
397 +as shown below (for an Athlon XP machine):
398 </p>
399
400 <pre caption="The GCC march setting">
401
402
403
404 --
405 gentoo-doc-cvs@g.o mailing list