[gentoo-doc-cvs] cvs commit: hb-install-ppc64-bootloader.xml hb-install-ppc64-disk.xml hb-install-ppc64-kernel.xml hb-install-ppc64-medium.xml

[Josh Saddler]

nightmorph    07/04/01 23:16:30

  Modified:             hb-install-ppc64-bootloader.xml
                        hb-install-ppc64-disk.xml
                        hb-install-ppc64-kernel.xml
                        hb-install-ppc64-medium.xml
  Log:
  ppc64 done

Revision  Changes    Path
1.15                 xml/htdocs/doc/en/handbook/draft/hb-install-ppc64-bootloader.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/hb-install-ppc64-bootloader.xml?rev=1.15&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/hb-install-ppc64-bootloader.xml?rev=1.15&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/hb-install-ppc64-bootloader.xml?r1=1.14&r2=1.15

Index: hb-install-ppc64-bootloader.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/hb-install-ppc64-bootloader.xml,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- hb-install-ppc64-bootloader.xml	14 Mar 2007 06:24:40 -0000	1.14
+++ hb-install-ppc64-bootloader.xml	1 Apr 2007 23:16:30 -0000	1.15
@@ -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/hb-install-ppc64-bootloader.xml,v 1.14 2007/03/14 06:24:40 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/hb-install-ppc64-bootloader.xml,v 1.15 2007/04/01 23:16:30 nightmorph Exp $ -->
 
 <sections>
 
-<version>7.0</version>
+<version>8.0</version>
 <date>2006-08-30</date>
 
 <section>
@@ -45,13 +45,12 @@
 </impo>
 
 <p>
-There are two ways to configure yaBoot for your system. You can use the
-new and improved <c>yabootconfig</c> included with
-<path>yaboot-1.3.8-r1</path> and later to automatically set up yaboot. If
-for some reason you do not want to run <c>yabootconfig</c> to
-automatically set up <path>/etc/yaboot.conf</path> or you are installing Gentoo
-on a G5 (on which <c>yabootconfig</c> does not always work), you can just edit 
-the sample file already installed on your system.
+There are two ways to configure yaBoot for your system. You can use the new and
+improved <c>yabootconfig</c> included with <path>yaboot-1.3.8-r1</path> and
+later to automatically set up yaboot. If for some reason you do not want to run
+<c>yabootconfig</c> to automatically set up <path>/etc/yaboot.conf</path> or you
+are installing Gentoo on a G5 (on which <c>yabootconfig</c> does not always
+work), you can just edit the sample file already installed on your system.
 </p>
 
 <impo>
@@ -102,19 +101,19 @@
 </pre>
 
 <p>
-Now run <c>yabootconfig</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 bootstrap partition, and install 
-the yaboot configuration file into it.
+Now run <c>yabootconfig</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 bootstrap partition, and install the
+yaboot configuration file into it.
 </p>
 
 <p>
-You might want to verify the contents of <path>/etc/yaboot.conf</path>. If 
-you make changes to <path>/etc/yaboot.conf</path> (like setting the 
-default/boot OS), make sure to rerun <c>ybin -v</c> to apply changes to the 
-bootstrap partition.
+You might want to verify the contents of <path>/etc/yaboot.conf</path>. If you
+make changes to <path>/etc/yaboot.conf</path> (like setting the default/boot
+OS), make sure to rerun <c>ybin -v</c> to apply changes to the bootstrap
+partition.
 </p>
 
 <p>
@@ -176,9 +175,9 @@
 
 <comment>#################
 ## This section can be duplicated if you have more than one kernel or set of
-## boot options - replace 2.6.17-gentoo-r5 with your kernel-version
+## boot options - replace <keyval id="kernel-name"/> with your kernel-version
 #################</comment>
-image=/boot/kernel-2.6.17-gentoo-r5
+image=/boot/<keyval id="kernel-name"/>
   label=Linux
   root=/dev/hda3
   partition=3
@@ -191,25 +190,22 @@
 </pre>
 
 <p>
-Once <path>yaboot.conf</path> is set up the way you want it, you run
-<c>mkofboot -v</c> to install the settings in the bootstrap partition.
-<e>Don't forget this!</e> Confirm when <c>mkofboot</c> asks you to create a new
-filesystem.
+Once <path>yaboot.conf</path> is set up the way you want it, you run <c>mkofboot
+-v</c> to install the settings in the bootstrap partition.  <e>Don't forget
+this!</e> Confirm when <c>mkofboot</c> asks you to create a new filesystem.
 </p>
 
 <p>
-If all goes well, and you have the same
-options as the sample above, your next reboot will give you a simple,
-five-entry boot menu. If you update your yaboot config later on, you'll
-just need to run <c>ybin -v</c> to update the bootstrap partition -
-<c>mkofboot</c> is for initial setup only.
+If all goes well, and you have the same options as the sample above, your next
+reboot will give you a simple, five-entry boot menu. If you update your yaboot
+config later on, you'll just need to run <c>ybin -v</c> to update the bootstrap
+partition - <c>mkofboot</c> is for initial setup only.
 </p>
 
 <p>
 For more information on yaboot, take a look at the <uri
-link="http://penguinppc.org/projects/yaboot">yaboot project</uri>. For
-now, continue the installation with <uri link="#reboot">Rebooting your 
-System</uri>.
+link="http://penguinppc.org/projects/yaboot">yaboot project</uri>. For now,
+continue the installation with <uri link="#reboot">Rebooting your System</uri>.
 </p>
 
 </body>
@@ -226,16 +222,22 @@
 
 <ul>
   <li>Install yaboot-static</li>
-  <li>Run 'dd if=/usr/lib/yaboot/yaboot.chrp of=/dev/sdXX' (fill in XX
-  with your disk and partition for the PReP partition; this was in our
-  example /dev/sda1)</li>
-  <li>Next construct your own yaboot.conf file and place into /etc.
-  (Take a look at the config above, look into the man page of
-  yaboot.conf or look at the below yaboot.conf example)</li>
-  <li>Assuming your boot device in OF is pointing to the harddrive you
-  prep boot partition is on then it'll just work, otherwise at IPL time,
-  go into the multiboot menu and set the boot device to the one with
-  your prep boot partition.</li>
+  <li>
+    Run <c>dd if=/usr/lib/yaboot/yaboot.chrp of=/dev/sdXX</c> (fill in XX with
+    your disk and partition for the PReP partition; this was in our example
+    <path>/dev/sda1</path>)
+  </li>
+  <li>
+    Next construct your own <path>yaboot.conf</path> file and place into
+    <path>/etc</path>. (Take a look at the config above, look into the man page
+    of yaboot.conf or look at the below <path>yaboot.conf</path> example.)
+  </li>
+  <li>
+    Assuming your boot device in OF is pointing to the harddrive you prep boot
+    partition is on then it'll just work, otherwise at IPL time, go into the
+    multiboot menu and set the boot device to the one with your prep boot
+    partition
+  </li>
   <li>That's it!</li>
 </ul>
 
@@ -246,22 +248,23 @@
 default=linux
 timeout=50
 
-image=/boot/kernel-2.6.17-gentoo-r5
+image=/boot/<keyval id="kernel-name"/>
     label=linux
     append="console=ttyS0,9600"
     read-only
 </pre>
 
 <p>
-For POWER4, POWER5, and blade-based hardware where the PReP disk partition 
-and the disk partition that contains your kernel are on the same physical disk,
-you can use a simplified yaboot.conf.  The following should be sufficient:
+For POWER4, POWER5, and blade-based hardware where the PReP disk partition and
+the disk partition that contains your kernel are on the same physical disk, you
+can use a simplified <path>yaboot.conf</path>. The following should be
+sufficient:
 </p>
 
 <pre caption="yaboot.conf for PReP hardware">
 default = linux
 timeout = 100
-image=/boot/kernel-2.6.17-gentoo-r5
+image=/boot/<keyval id="kernel-name"/>
         label=linux
         read-only
         root = /dev/sda2



1.17                 xml/htdocs/doc/en/handbook/draft/hb-install-ppc64-disk.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/hb-install-ppc64-disk.xml?rev=1.17&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/hb-install-ppc64-disk.xml?rev=1.17&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/hb-install-ppc64-disk.xml?r1=1.16&r2=1.17

Index: hb-install-ppc64-disk.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/hb-install-ppc64-disk.xml,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- hb-install-ppc64-disk.xml	14 Mar 2007 07:31:43 -0000	1.16
+++ hb-install-ppc64-disk.xml	1 Apr 2007 23:16:30 -0000	1.17
@@ -4,7 +4,7 @@
 <!-- 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/hb-install-ppc64-disk.xml,v 1.16 2007/03/14 07:31:43 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/hb-install-ppc64-disk.xml,v 1.17 2007/04/01 23:16:30 nightmorph Exp $ -->
 
 <sections>
 
@@ -104,11 +104,10 @@
 
 <note>
 There are some partitions named like this: <path>Apple_Driver43,
-Apple_Driver_ATA, 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.
-You might have to use parted in order to delete them, as mac-fdisk can't delete
-them yet.
+Apple_Driver_ATA, 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.  You might have to use parted in order to delete them, as
+mac-fdisk can't delete them yet.
 </note>
 
 <p>
@@ -129,14 +128,14 @@
 The number of partitions is highly dependent on your environment. For instance,
 if you have lots of users, you will most likely want to have your
 <path>/home</path> separate as it increases security and makes backups easier.
-If you are installing Gentoo to perform as a mailserver, your 
-<path>/var</path> should be separate as all mails are stored inside 
-<path>/var</path>. A good choice of filesystem will then maximise your 
-performance. Gameservers will have a separate <path>/opt</path> as most gaming 
-servers are installed there. The reason is similar for <path>/home</path>: 
-security and backups. You will definitely want to keep <path>/usr</path> big:
-not only will it contain the majority of applications, the Portage tree alone
-takes around 500 Mbyte excluding the various sources that are stored in it.
+If you are installing Gentoo to perform as a mailserver, your <path>/var</path>
+should be separate as all mails are stored inside <path>/var</path>. A good
+choice of filesystem will then maximise your performance. Gameservers will have
+a separate <path>/opt</path> as most gaming servers are installed there. The
+reason is similar for <path>/home</path>: security and backups. You will
+definitely want to keep <path>/usr</path> big: not only will it contain the
+majority of applications, the Portage tree alone takes around 500 Mbyte
+excluding the various sources that are stored in it.
 </p>
 
 <p>
@@ -164,17 +163,17 @@
 </ul>
 
 <p>
-However, multiple partitions have one big disadvantage: if not configured 
-properly, you might result in having a system with lots
-of free space on one partition and none on another. There is also a 15-partition
-limit for SCSI and SATA.
+However, multiple partitions have one big disadvantage: if not configured
+properly, you might result in having a system with lots of free space on one
+partition and none on another. There is also a 15-partition limit for SCSI and
+SATA.
 </p>
 
 </body>
 </subsection>
 </section>
 <section id="mac-fdisk">
-<title>Default: Using mac-fdisk (Apple G5) Partition your Disk</title>
+<title>Default: Using mac-fdisk (Apple G5) to Partition your Disk</title>
 <body>
 
 <p>
@@ -225,10 +224,10 @@
 
 <note>
 To make sure everything is ok, you should run mac-fdisk once more and check
-whether all the partitions are there.If you don't see any of the partitions you
+whether all the partitions are there. If you don't see any of the partitions you
 created, or the changes you made, you should reinitialize your partitions by
-pressing "i" in mac-fdisk. Note that this will recreate the partition map and
-thus remove all your partitions. 
+pressing <c>i</c> in mac-fdisk. Note that this will recreate the partition map
+and thus remove all your partitions. 
 </note>
     
 <p>
@@ -244,14 +243,14 @@
 <body>
 
 <note>
-If you are planning to use a RAID disk array for your gentoo installation and 
+If you are planning to use a RAID disk array for your Gentoo installation and 
 you are using POWER5-based hardware, you should now run <c>iprconfig</c> to 
 format the disks to Advanced Function format and create the disk array. You
 should emerge <c>iprutils</c> after your install is complete.
 </note>
 
 <p>
-If you have an ipr based SCSI adapter, you should start the ipr utilities now.
+If you have an ipr-based SCSI adapter, you should start the ipr utilities now.
 </p>
 
 <pre caption="Starting ipr utilities">
@@ -647,8 +646,7 @@
 
 <p>
 <b>JFS</b> is IBM's high-performance journaling filesystem. It has recently 
-become production-ready and there hasn't been a sufficient track record to 
-comment positively nor negatively on its general stability at this point.
+become production-ready.
 </p>
 
 </body>
@@ -740,7 +738,7 @@
 Now that your partitions are initialized and are housing a filesystem, it is
 time to mount those partitions. Use the <c>mount</c> command. Don't forget to
 create the necessary mount directories for every partition you created. As an
-example we create a mount-point and mount the root and boot partition:
+example we create a mount point and mount the root and boot partition:
 </p>
 
 <pre caption="Mounting partitions">



1.15                 xml/htdocs/doc/en/handbook/draft/hb-install-ppc64-kernel.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/hb-install-ppc64-kernel.xml?rev=1.15&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/hb-install-ppc64-kernel.xml?rev=1.15&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/hb-install-ppc64-kernel.xml?r1=1.14&r2=1.15

Index: hb-install-ppc64-kernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/hb-install-ppc64-kernel.xml,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- hb-install-ppc64-kernel.xml	19 Mar 2007 08:20:15 -0000	1.14
+++ hb-install-ppc64-kernel.xml	1 Apr 2007 23:16:30 -0000	1.15
@@ -4,7 +4,7 @@
 <!-- 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/hb-install-ppc64-kernel.xml,v 1.14 2007/03/19 08:20:15 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/hb-install-ppc64-kernel.xml,v 1.15 2007/04/01 23:16:30 nightmorph Exp $ -->
 
 <sections>
 
@@ -57,13 +57,13 @@
 <p>
 When you take a look in <path>/usr/src</path> you should see a symlink called
 <path>linux</path> pointing to your kernel source. In this case, the installed
-kernel source points to <c>gentoo-sources-2.6.17-r5</c>. Your version may be
-different, so keep this in mind.
+kernel source points to <c>gentoo-sources-<keyval id="kernel-version"/></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      12 Oct 13 11:04 /usr/src/linux -&gt; linux-2.6.17-gentoo-r5
+lrwxrwxrwx   1 root   root      12 Oct 13 11:04 /usr/src/linux -&gt; linux-<keyval id="kernel-version"/>
 </pre>
 
 <p>
@@ -107,8 +107,8 @@
 <pre caption="Invoking menuconfig">
 # <i>cd /usr/src/linux</i>
 <comment>Important: In case you are in 32-bit userland, you must edit the top
-level Makefile in /usr/src/linux and change the CROSS_COMPILE option to 
-CROSS_COMPILE ?= powerpc64-unknown-linux-gnu-. You must do this before you run 
+level Makefile in /usr/src/linux and change the CROSS_COMPILE option to
+CROSS_COMPILE ?= powerpc64-unknown-linux-gnu-. You must do this before you run
 make menuconfig or it may result in kernel compilation problems.</comment>
 # <i>make menuconfig</i>
 </pre>



1.23                 xml/htdocs/doc/en/handbook/draft/hb-install-ppc64-medium.xml

file : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/hb-install-ppc64-medium.xml?rev=1.23&view=markup
plain: http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/hb-install-ppc64-medium.xml?rev=1.23&content-type=text/plain
diff : http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/handbook/draft/hb-install-ppc64-medium.xml?r1=1.22&r2=1.23

Index: hb-install-ppc64-medium.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/hb-install-ppc64-medium.xml,v
retrieving revision 1.22
retrieving revision 1.23
diff -u -r1.22 -r1.23
--- hb-install-ppc64-medium.xml	19 Mar 2007 10:26:44 -0000	1.22
+++ hb-install-ppc64-medium.xml	1 Apr 2007 23:16:30 -0000	1.23
@@ -4,7 +4,7 @@
 <!-- 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/hb-install-ppc64-medium.xml,v 1.22 2007/03/19 10:26:44 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/draft/hb-install-ppc64-medium.xml,v 1.23 2007/04/01 23:16:30 nightmorph Exp $ -->
 
 <sections>
 
@@ -87,8 +87,7 @@
 <p>
 If you wish to install Gentoo without a working Internet connection, please use
 the installation instructions described in the <uri
-link="2007.0/index.xml">Gentoo 2007.0 Handbooks</uri>. This is currently not
-supported for the PPC64 architecture though.
+link="2007.0/index.xml">Gentoo 2007.0 Handbooks</uri>.
 </p>
 
 <p>
@@ -210,10 +209,10 @@
 </p>
 
 <p>
-You can download any of the Installation CDs (and, if you want to, a Packages
-CD as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The
-Installation CDs are located in the
-<path>releases/ppc/2007.0/ppc64/installcd</path> directory.
+You can download any of the Installation CDs (and, if you want to, a Packages CD
+as well) from one of our <uri link="/main/en/mirrors.xml">mirrors</uri>. The
+Installation CDs are located in the <path><keyval
+id="release-dir"/>installcd</path> directory.
 </p>
 
 <p>
@@ -306,15 +305,15 @@
     This option takes one of the following vendor-specific tags:
     <c>radeonfb</c>, <c>rivafb</c>, <c>atyfb</c>, <c>aty128</c>, <c>nvidiafb</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.
+    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.
   </ti>
 </tr>
 <tr>
   <ti><c>nol3</c></ti>
   <ti>
-    Disables level 3 cache on some powerbooks (needed for at least the 17'')
+    Disables level 3 cache on some powerbooks (needed for at least the 17")
   </ti>
 </tr>
 <tr>
@@ -433,11 +432,11 @@
 
 <p>
 When the Installation CD boots, it tries to detect all your hardware devices and
-loads the appropriate kernel modules to support your hardware. In the
-vast majority of cases, it does a very good job. However, in some cases it may 
-not auto-load the kernel 
-modules you need. If the PCI auto-detection missed some of your system's 
-hardware, you will have to load the appropriate kernel modules manually. 
+loads the appropriate kernel modules to support your hardware. In the vast
+majority of cases, it does a very good job. However, in some cases it may not
+auto-load the kernel modules you need. If the PCI auto-detection missed some of
+your system's hardware, you will have to load the appropriate kernel modules
+manually. 
 </p>
 
 <p>
@@ -473,8 +472,10 @@
 </p>
 
 <pre caption="Tweaking hard disk performance">
-<comment>Activate DMA:</comment>                                       # <i>hdparm -d 1 /dev/hda</i>
-<comment>Activate DMA + Safe Performance-enhancing Options:</comment>  # <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
+<comment>Activate DMA:</comment>
+# <i>hdparm -d 1 /dev/hda</i>
+<comment>Activate DMA + Safe Performance-enhancing Options:</comment>
+# <i>hdparm -d 1 -A 1 -m 16 -u 1 -a 64 /dev/hda</i>
 </pre>
 
 </body>



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