[gentoo-doc-cvs] cvs commit: handbook-ppc.xml

[Joseph Jezak]

josejx      06/02/13 17:07:35

  Modified:    xml/htdocs/doc/en/handbook/draft/2006.0 handbook-ppc.xml
                        hb-install-config.xml hb-install-ppc-bootloader.xml
                        hb-install-ppc-disk.xml hb-install-ppc-kernel.xml
                        hb-install-ppc-medium.xml
  Log:
  PPC specific fixes for bug #122406.

Revision  Changes    Path
1.4       +6 -3      xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc.xml

file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc.xml?rev=1.4&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc.xml?rev=1.4&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc.xml.diff?r1=1.3&r2=1.4&cvsroot=gentoo

Index: handbook-ppc.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc.xml,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- handbook-ppc.xml	10 Feb 2006 17:45:04 -0000	1.3
+++ handbook-ppc.xml	13 Feb 2006 17:07:35 -0000	1.4
@@ -1,7 +1,7 @@
 <?xml version='1.0' encoding='UTF-8'?>
 <!DOCTYPE book SYSTEM "/dtd/book.dtd">
 
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc.xml,v 1.3 2006/02/10 17:45:04 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/handbook-ppc.xml,v 1.4 2006/02/13 17:07:35 josejx Exp $ -->
 
 <book link="handbook-ppc.xml">
 <title>Gentoo Linux 2006.0 PPC Handbook</title>
@@ -101,6 +101,9 @@
 <author title="Editor">
   <mail link="neysx@g.o">Xavier Neys</mail>
 </author>
+<author title="Editor">
+  <mail link="josejx@g.o">Joseph Jezak</mail>
+</author>
 <author title="Reviewer">
     <mail link="g2boojum@g.o">Grant Goodyear</mail>
 </author>
@@ -124,8 +127,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>5.2</version>
-<date>2005-10-13</date>
+<version>5.3</version>
+<date>2006-02-09</date>
 
 <part>
 <title>Installing Gentoo</title>



1.2       +5 -4      xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-config.xml

file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-config.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-config.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-config.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo

Index: hb-install-config.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-config.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-config.xml	1 Feb 2006 18:38:17 -0000	1.1
+++ hb-install-config.xml	13 Feb 2006 17:07:35 -0000	1.2
@@ -4,12 +4,12 @@
 <!-- The content of this document is licensed under the CC-BY-SA license -->
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-config.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-config.xml,v 1.2 2006/02/13 17:07:35 josejx Exp $ -->
 
 <sections>
 
-<version>5.3</version>
-<date>2005-11-19</date>
+<version>5.4</version>
+<date>2006-02-09</date>
 
 <section>
 <title>Filesystem Information</title>
@@ -80,7 +80,8 @@
 <p>
 Let us take a look at how we write down the options for the <path>/boot</path>
 partition. This is just an example, so if your architecture doesn't require a
-<path>/boot</path> partition (such as <b>PPC</b>), don't copy it verbatim.
+<path>/boot</path> partition (such as Apple <b>PPC</b> machines), don't copy it
+verbatim.
 </p>
 
 <p>



1.2       +33 -21    xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-bootloader.xml

file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-bootloader.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-bootloader.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-bootloader.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo

Index: hb-install-ppc-bootloader.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-bootloader.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-ppc-bootloader.xml	1 Feb 2006 18:38:17 -0000	1.1
+++ hb-install-ppc-bootloader.xml	13 Feb 2006 17:07:35 -0000	1.2
@@ -4,12 +4,12 @@
 <!-- The content of this document is licensed under the CC-BY-SA license -->
 <!-- See http://creativecommons.org/licenses/by-sa/1.0 -->
 
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-bootloader.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-bootloader.xml,v 1.2 2006/02/13 17:07:35 josejx Exp $ -->
 
 <sections>
 
-<version>5.3</version>
-<date>2006-01-19</date>
+<version>5.4</version>
+<date>2006-02-09</date>
 
 <section>
 <title>Choosing a Bootloader</title>
@@ -45,14 +45,19 @@
 </impo>
 
 <p>
-In order to find the boot devices, yaboot needs access to the <path>/dev</path>
-filesystem.  To do this, you will need to "bind-map" the <path>/dev</path> 
-filesystem from the Installation CD to <path>/dev</path> inside of the chroot.
+In order to find the boot devices, yaboot needs access to the device nodes
+created by udev on startup and the sysfs filesystem.  These two filesystems
+are found at <path>/dev</path> and <path>sys</path> respectively.  To do this,
+you will need to "bind mount" these filesystems from the Installation CD's root
+to the <path>/dev</path> and <path>/sys</path> mount points inside the chroot.
+If you have already bind mounted these filesystems, there is no need to do it
+again.
 </p>
 
-<pre caption="Bind-mounting the /dev-filesystem">
+<pre caption="Bind-mounting the device and sysfs filesystems">
 # <i>exit </i> # this will exit the chroot
 # <i>mount -o bind /dev /mnt/gentoo/dev</i>
+# <i>mount -o bind /sys /mnt/gentoo/sys</i>
 # <i>chroot /mnt/gentoo /bin/bash</i>
 # <i>/usr/sbin/env-update &amp;&amp; source /etc/profile </i>
 </pre>
@@ -107,9 +112,10 @@
 
 <p>
 To use <c>yabootconfig</c>, your drive must have an Apple_Bootstrap partition,
-and <path>/etc/fstab</path> must be configured with your Linux partitions. Both
-of these should have been done already in the steps above. To start, ensure that
-you have the latest <c>yaboot</c> installed.
+and <path>/etc/fstab</path> must be configured to reflect your Linux 
+partitions. These steps should have already been completed before, but check
+<path>/etc/fstab</path> before proceeding.  Now, ensure that you have the 
+latest <c>yaboot</c> installed.
 </p>
 
 <pre caption = "Installing yaboot with GRP">
@@ -117,15 +123,17 @@
 </pre>
 
 <p>
-Now exit the chroot and run <c>yabootconfig --chroot /mnt/gentoo</c>. The
-program will run and it will confirm the location of the bootstrap partition.
-Type <c>Y</c> if it is correct. If not, double check <path>/etc/fstab</path>.
-yabootconfig will then scan your system setup, create
-<path>/etc/yaboot.conf</path> and run <c>mkofboot</c> for you. <c>mkofboot</c>
-is used to format the Apple_Bootstrap partition, and install the yaboot
-configuration file into it.  After this enter the chroot again.
+Now exit the chroot and run <c>yabootconfig --chroot /mnt/gentoo</c>. First,
+the program will confirm the location of the bootstrap partition.  If you are
+using the suggested disk partitioning scheme, your bootstrap partition should
+be /dev/hda2. Type <c>Y</c> if the output is correct. If not, double check your
+<path>/etc/fstab</path>. <c>yabootconfig</c> will then scan your system setup, 
+create <path>/etc/yaboot.conf</path> and run <c>mkofboot</c> for you. 
+<c>mkofboot</c> is used to format the Apple_Bootstrap partition, and install 
+the yaboot configuration file into it.  After this enter the chroot again.
 </p>
-<pre caption="enter chroot">
+
+<pre caption="Re-enter the chroot">
 # <i>chroot /mnt/gentoo /bin/bash</i>
 # <i>/usr/sbin/env-update &amp;&amp; source /etc/profile</i>
 </pre>
@@ -148,8 +156,7 @@
 <body>
 
 <p>
-First make sure you have the latest <c>yaboot</c> installed on your
-system:
+First make sure you have the latest <c>yaboot</c> installed on your system:
 </p>
 
 <pre caption = "Installing yaboot">
@@ -313,6 +320,12 @@
 page</uri> for more information.
 </p>
 
+<impo>
+Make sure that you have support for HFS and HFS+ filesystems in your kernel,
+otherwise you will not be able to upgrade or change the kernel on your MacOS 
+partition.
+</impo>
+
 <p>
 Now reboot again and boot into Linux, then continue with <uri
 link="?part=1&amp;chap=11">Finalizing your Gentoo Installation</uri>.
@@ -494,7 +507,6 @@
 System</uri>.
 </p>
 
-
 </body>
 </section>
 <section id="reboot">



1.2       +14 -15    xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-disk.xml

file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-disk.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-disk.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-disk.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo

Index: hb-install-ppc-disk.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-disk.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-ppc-disk.xml	1 Feb 2006 18:38:17 -0000	1.1
+++ hb-install-ppc-disk.xml	13 Feb 2006 17:07:35 -0000	1.2
@@ -4,12 +4,12 @@
 <!-- The content of this document is licensed under the CC-BY-SA license -->
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-disk.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-disk.xml,v 1.2 2006/02/13 17:07:35 josejx Exp $ -->
 
 <sections>
 
-<version>5.1</version>
-<date>2005-08-25</date>
+<version>5.2</version>
+<date>2006-02-09</date>
 
 <section>
 <title>Introduction to Block Devices</title>
@@ -26,10 +26,10 @@
 </p>
 
 <p>
-To begin, we'll introduce <e>block devices</e>. The most famous block device is
-probably the one that represents the first IDE drive in a Linux system, namely
-<path>/dev/hda</path>. If your system uses SCSI or SATA drives, then your first
-hard drive would be <path>/dev/sda</path>.
+To begin, we'll introduce <e>block devices</e>. The most common block device is
+the one that represents the first IDE drive in a Linux system, namely
+<path>/dev/hda</path>. If you are installing onto SCSI, FireWire, USB or SATA 
+drives, then your first hard drive would be <path>/dev/sda</path>.
 </p>
 
 <p>
@@ -108,7 +108,7 @@
   <ti>(Not applicable)</ti>
   <ti><path>/dev/hda2</path> (If using quik)</ti>
   <ti><path>/dev/hda1</path></ti>
-  <ti>(Not needed)</ti>
+  <ti>(Not applicable)</ti>
   <ti>ext2</ti>
   <ti>32MB</ti>
   <ti>Boot partition</ti>
@@ -138,15 +138,15 @@
 Apple_FWDriver, Apple_Driver_IOKit, Apple_Patches</path>. If you are not 
 planning to use MacOS 9 you can delete them, because MacOS X and Linux don't 
 need them.  To delete them, either use parted or erase the whole disk by 
-initialing the partition map.
+initializing the partition map.
 </note>
 
 <warn>
-<c>parted</c> is able to resize partitions.  On the Installation CD there 
-are patches included to resize HFS+ filesystem.  Unfortunately it is not 
-possible to resize HFS+ journaled filesystems, even if the journaling has been 
-switchedoff in Mac OS X.  Everything you do with resizing in parted you do it 
-on your own risk!  Be sure to have a backup of your data!
+<c>parted</c> is able to resize partitions including HFS+. Unfortunately it is
+not possible to resize HFS+ journaled filesystems, so switch off journaling in
+Mac OS X before resizing.  Remeber that any resizing operation is dangerous,
+so attempt at your own risk!  Be sure to always have a backup of your data 
+before resizing!
 </warn>
 
 <p>
@@ -522,7 +522,6 @@
 also holds for <path>/var/tmp</path>.
 </note>
 
-
 <p>
 We will have to mount the proc filesystem (a virtual interface with the
 kernel) on <path>/proc</path>. But first we will need to place our files on the



1.2       +21 -8     xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-kernel.xml

file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-kernel.xml?rev=1.2&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-kernel.xml?rev=1.2&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-kernel.xml.diff?r1=1.1&r2=1.2&cvsroot=gentoo

Index: hb-install-ppc-kernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-kernel.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- hb-install-ppc-kernel.xml	1 Feb 2006 18:38:17 -0000	1.1
+++ hb-install-ppc-kernel.xml	13 Feb 2006 17:07:35 -0000	1.2
@@ -4,12 +4,12 @@
 <!-- The content of this document is licensed under the CC-BY-SA license -->
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-kernel.xml,v 1.1 2006/02/01 18:38:17 fox2mike Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-kernel.xml,v 1.2 2006/02/13 17:07:35 josejx Exp $ -->
 
 <sections>
 
-<version>5.4</version>
-<date>2006-01-06</date>
+<version>5.5</version>
+<date>2006-02-09</date>
 
 <section>
 <title>Timezone</title>
@@ -62,13 +62,13 @@
 <p>
 If you take a look in <path>/usr/src</path> you should see a symlink named
 <path>linux</path> pointing to your current kernel source. In this case, the
-installed kernel source points to <c>gentoo-sources-2.6.12-r6</c>. Your version
+installed kernel source points to <c>gentoo-sources-2.6.15</c>. Your version
 may be different, so keep this in mind.
 </p>
 
 <pre caption="Viewing the kernel source symlink">
 # <i>ls -l /usr/src/linux</i>
-lrwxrwxrwx    1 root     root           22  Mar 18 16:23 /usr/src/linux -&gt; linux-2.6.12-gentoo-r6
+lrwxrwxrwx    1 root     root           22  Mar 18 16:23 /usr/src/linux -&gt; linux-2.6.15
 </pre>
 
 <p>
@@ -295,13 +295,26 @@
 
 <p>
 When the kernel has finished compiling, copy the kernel image to
-<path>/boot</path> (be sure that it is mounted properly on the Pegasos).
+<path>/boot</path> (be sure that it is mounted properly on Pegasos computers).
+If you are using BootX to boot, we'll copy the kernel later.
+</p>
+
+<p>
+Yaboot and BootX expect to use an uncompressed kernel unlike many other 
+bootloaders.  The uncompressed kernel is called vmlinux and it is placed in
+<path>/usr/src/linux</path> after the kernel has finished compiling.  If you
+are using a Pegasos machine, the Pegasos firmware requires a compressed
+kernel called zImage.chrp which can be found in 
+<path>/usr/src/linux/arch/ppc/boot/images</path>.
 </p>
 
 <pre caption="Installing the kernel">
+# <i>cd /usr/src/linux</i>
 <comment>replace &lt;kernel-version&gt; with your kernel version</comment>
-(Apple/IBM)  # <i>cp vmlinux /boot/&lt;kernel-version&gt;</i>
-(Pegasos)    # <i>cp arch/ppc/boot/images/zImage.chrp /boot/&lt;kernel-version&gt;</i>
+<comment>(Apple/IBM)</comment>
+# <i>cp vmlinux /boot/&lt;kernel-version&gt;</i> 
+<comment>(Pegasos)</comment>
+# <i>cp arch/ppc/boot/images/zImage.chrp /boot/&lt;kernel-version&gt;</i> 
 </pre>
 
 <p>



1.3       +42 -31    xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-medium.xml

file : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-medium.xml?rev=1.3&content-type=text/x-cvsweb-markup&cvsroot=gentoo
plain: http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-medium.xml?rev=1.3&content-type=text/plain&cvsroot=gentoo
diff : http://www.gentoo.org/cgi-bin/viewcvs.cgi/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-medium.xml.diff?r1=1.2&r2=1.3&cvsroot=gentoo

Index: hb-install-ppc-medium.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-medium.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- hb-install-ppc-medium.xml	12 Feb 2006 20:56:43 -0000	1.2
+++ hb-install-ppc-medium.xml	13 Feb 2006 17:07:35 -0000	1.3
@@ -4,11 +4,11 @@
 <!-- The content of this document is licensed under the CC-BY-SA license -->
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-medium.xml,v 1.2 2006/02/12 20:56:43 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/2006.0/hb-install-ppc-medium.xml,v 1.3 2006/02/13 17:07:35 josejx Exp $ -->
 
 <sections>
 
-<version>5.4</version>
+<version>5.5</version>
 <date>2006-02-12</date>
 
 <section>
@@ -71,8 +71,9 @@
 </table>
 
 <p>
-Be sure to read up on the <uri link="/doc/en/gentoo-ppc-faq.xml">Gentoo 
-PPC FAQ</uri> before you begin.
+Be sure to read the <uri link="/doc/en/gentoo-ppc-faq.xml">Gentoo PPC FAQ</uri>
+for help with some common installation related issues or if you're unsure as to
+just what's in that PowerPC machine you've got sitting on your desk right now.
 </p>
 
 </body>
@@ -240,15 +241,13 @@
 </p>
 
 <p>
-At this prompt you are able to select a kernel for the subarchitecture you use.
-We provide <c>G3</c>, <c>G4</c> and <c>G5</c>. All kernels are built with
-support for multiple CPUs, but they will boot on single processor machines as
-well.
+We provide one generic kernel, <e>ppc32</e>. This kernel is built with support
+for multiple CPUs, but it will boot on single processor machines as well.
 </p>
 
 <p>
-You are also able to tweak some kernel options at this prompt. The following
-table lists some of the available boot options you can add:
+You can tweak some kernel options at this prompt. The following table lists 
+some of the available boot options you can add:
 </p>
 
 <table>
@@ -260,10 +259,13 @@
   <ti><c>video</c></ti>
   <ti>
     This option takes one of the following vendor-specific tags:
-    <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, <c>aty128</c> or
-    <c>ofonly</c>. You can follow this tag with the resolution and refreshrate
-    you want to use. For instance <c>video=radeonfb:1280x1024@75</c>. If you are
-    uncertain what to choose, <c>ofonly</c> will most certainly work.
+    <c>nvidiafb</c>, <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, 
+    <c>aty128</c> or <c>ofonly</c>. You can follow this tag with the resolution 
+    refresh rate and color depth you want to use. For instance,
+    <c>video=radeonfb:1280x1024@75-32</c> will select the ATI Radeon frame buffer
+    at a resolution of 1280x1024 with a refresh rate of 75Hz and a color depth of
+    32 bits. If you are uncertain what to choose, and the default doesn't work,
+    <c>video=ofonly</c> will most certainly work.
   </ti>
 </tr>
 <tr>
@@ -303,10 +305,10 @@
 On the Pegasos simply insert the CD and at the SmartFirmware boot-prompt type
 <c>boot cd /boot/menu</c>. This will open a small bootmenu where you can choose
 between several preconfigured video configs. If you need any special boot
-options you can append them to the command-line. For instance <c>boot cd
-/boot/pegasos video=radeonfb:1280x1024@75 mem=256M</c>.  The complete list of
-kernel appends (in case something goes wrong and you need it) is preconfigured
-in the kernel with <c>console=ttyS0,115200 console=tty0 init=/linuxrc
+options you can append them to the command-line just like with Yaboot above. 
+For example: <c>boot cd /boot/pegasos video=radeonfb:1280x1024@75 mem=256M</c>.
+The default kernel options (in case something goes wrong and you need it) are 
+preconfigured with <c>console=ttyS0,115200 console=tty0 init=/linuxrc 
 looptype=squashfs loop=/livecd.squashfs udev nodevfs cdroot root=/dev/ram0</c>.
 </p>
 
@@ -320,8 +322,7 @@
 <p>
 If you have an OldWorld Mac the bootable portion of the livecd can't be used.
 The most simple solution is to use MacOS to bootstrap into a Linux environment
-with a tool called BootX.  Boot floppies are being prepared for Macs without
-MacOS, but they are not available at this time.
+with a tool called BootX.  
 </p>
 
 <p>
@@ -330,14 +331,14 @@
 archive into <c>Extensions Folder</c> and the BootX App Control Panel into
 <c>Control Panels</c>, both of which are located in your MacOS System Folder.
 Next, create a folder called "Linux Kernels" in your System folder and copy the
-<c>G3G4</c> kernel from the CD to this folder.  Finally, copy <c>G3G4.igz</c> 
+<c>ppc32</c> kernel from the CD to this folder.  Finally, copy <c>ppc32.igz</c> 
 from the Installation CD <path>boot</path> folder into the MacOS 
 <c>System Folder</c>.
 </p>
 
 <p>
 To prepare BootX, start the BootX App Control Panel.  First select the Options
-dialog and check <c>Use Specified RAM Disk</c> and select <c>G3G4.igz</c> from
+dialog and check <c>Use Specified RAM Disk</c> and select <c>ppc32.igz</c> from
 your System Folder.  Continue back to the initial screen and ensure that the
 ramdisk size is at least <c>32000</c>.  Finally, set the kernel arguments as
 shown below:
@@ -348,15 +349,16 @@
 </pre>
 
 <note>
-The kernel parameters in the yaboot section above are also applicable here.
+The kernel parameters in the yaboot section above are also applicable here. You
+can append any of those options to the kernel arguments above.
 </note>
 
 <p>
 Check once more to make sure the settings are correct and then save the 
 configuration.  This saves typing just in case it doesn't boot or something is
-missing.  Press the Linux button at the top of the window to boot into the 
-Installation CD and continue with <uri link="#booted">And When 
-You're Booted...</uri>
+missing.  Press the Linux button at the top of the window.  If everything goes
+correctly, it should boot into the Installation CD. Continue with 
+<uri link="#booted">And When You're Booted...</uri>
 </p>
 
 </body>
@@ -369,8 +371,8 @@
 <p>
 You will be greeted by a root ("#") prompt on the current console. You can also 
 switch to other consoles by pressing Alt-F2, Alt-F3 and Alt-F4. Get 
-back to the one you started on by pressing Alt-F1.  Probably you have to hit
-Alt-fn-Fx on Apple machines.
+back to the one you started on by pressing Alt-F1.  Due to the keyboard layout,
+you may need to press Alt-fn-Fx on Apple machines.
 </p>
 
 <p>
@@ -417,14 +419,23 @@
 
 <p>
 In the next example we try to load the <c>airport</c> module.  This module
-supports only the old Airport cards (b-net).  AirportExtreme is not supported
-under Linux:
+supports only the old Airport cards (802.11b).  Airport Extreme (802.11g) is not
+supported on the InstallCD due to restrictions on firmware distribution.
 </p>
 
-<pre caption="Loading kernel modules">
+<pre caption="Loading the airport module">
 # <i>modprobe airport</i>
 </pre>
 
+<p>
+On older iMacs, sometimes the network card is not detected properly.  These use
+the BMAC driver:
+</p>
+
+<pre caption="Loading the bmac module">
+# <i>modprobe bmac</i>
+</pre>
+
 </body>
 </subsection>
 <subsection>



-- 
gentoo-doc-cvs@g.o mailing list