[gentoo-doc-cvs] gentoo commit in xml/htdocs/doc/en/handbook: handbook-hppa.xml hb-install-hppa-bootloader.xml hb-install-hppa-disk.xml hb-install-hppa-kernel.xml hb-install-hppa-medium.xml

[Joshua Saddler (nightmorph)]

nightmorph    10/07/20 00:05:24

  Modified:             handbook-hppa.xml hb-install-hppa-bootloader.xml
                        hb-install-hppa-disk.xml hb-install-hppa-kernel.xml
                        hb-install-hppa-medium.xml
  Log:
  Update HPPA handbook for the weekly autobuilds. Note that HPPA users must still download and boot a 2008.0 liveCD, as there aren't any weekly CDs. I guess the hardware is old and won't really change. Once there's a more recent CD, we can change hb-install-hppa-medium.xml to use the correct conditional include for the autobuild CD directory. Fixes bug 260403, bug 292726, and bug 234310.

Revision  Changes    Path
1.138                xml/htdocs/doc/en/handbook/handbook-hppa.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml?rev=1.138&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml?rev=1.138&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml?r1=1.137&r2=1.138

Index: handbook-hppa.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml,v
retrieving revision 1.137
retrieving revision 1.138
diff -u -r1.137 -r1.138
--- handbook-hppa.xml	6 Jul 2008 08:00:30 -0000	1.137
+++ handbook-hppa.xml	20 Jul 2010 00:05:24 -0000	1.138
@@ -1,6 +1,6 @@
 <?xml version='1.0' encoding='UTF-8'?>
 <!DOCTYPE book SYSTEM "/dtd/book.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml,v 1.137 2008/07/06 08:00:30 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/handbook-hppa.xml,v 1.138 2010/07/20 00:05:24 nightmorph Exp $ -->
 
 <book>
 <title>Gentoo Linux HPPA Handbook</title>
@@ -8,13 +8,14 @@
 <values>
  <key id="arch">HPPA</key>
  <key id="/boot">/dev/sda2</key>
- <key id="kernel-version">2.6.23-gentoo-r8</key>
- <key id="kernel-name">kernel-2.6.23-gentoo-r8</key>
- <key id="min-cd-name">install-hppa-minimal-2008.0.iso</key>
+ <key id="kernel-version">2.6.34-gentoo-r1</key>
+ <key id="kernel-name">kernel-2.6.34-gentoo-r1</key>
+ <key id="min-cd-name">install-hppa-minimal-&lt;release&gt;.iso</key>
+ <key id="min-cd-size">124</key>
  <key id="online-book">handbook-hppa.xml</key>
- <key id="release-dir">releases/hppa/2008.0/hppa2.0/</key>
- <key id="stage3">stage3-hppa2.0-2008.0.tar.bz2</key>
- <key id="profile">default/linux/hppa/2008.0</key>
+ <key id="release-dir">releases/hppa/autobuilds/</key>
+ <key id="stage3">stage3-hppa2.0-&lt;release&gt;.tar.bz2</key>
+ <key id="profile">default/linux/hppa/10.0</key>
  <key id="CFLAGS">-march=2.0 -O2 -pipe</key>
 </values>
 
@@ -136,8 +137,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>9.5</version>
-<date>2008-07-06</date>
+<version>10.0</version>
+<date>2010-07-19</date>
 
 <part>
 <title>Installing Gentoo</title>



1.18                 xml/htdocs/doc/en/handbook/hb-install-hppa-bootloader.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-bootloader.xml?rev=1.18&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-bootloader.xml?rev=1.18&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-bootloader.xml?r1=1.17&r2=1.18

Index: hb-install-hppa-bootloader.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-bootloader.xml,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -r1.17 -r1.18
--- hb-install-hppa-bootloader.xml	1 Apr 2008 08:53:46 -0000	1.17
+++ hb-install-hppa-bootloader.xml	20 Jul 2010 00:05:24 -0000	1.18
@@ -4,20 +4,20 @@
 <!-- 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/hb-install-hppa-bootloader.xml,v 1.17 2008/04/01 08:53:46 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-bootloader.xml,v 1.18 2010/07/20 00:05:24 nightmorph Exp $ -->
 
 <sections>
 
-<version>9.0</version>
-<date>2008-04-01</date>
+<version>10.0</version>
+<date>2010-07-19</date>
 
 <section>
 <title>Installing PALO</title>
 <body>
 
 <p>
-On the PA-RISC platform, the boot loader is called palo. You may need to emerge
-it on your machine first.
+On the PA-RISC platform, the boot loader is called <c>palo</c>. You may need to
+emerge it on your machine first.
 </p>
 
 <pre caption="Installing palo">
@@ -29,7 +29,7 @@
 sample configuration:
 </p>
 
-<pre caption = "/etc/palo.conf example">
+<pre caption="/etc/palo.conf example">
 --commandline=2/<keyval id="kernel-name"/> root=/dev/sda4
 --recoverykernel=/vmlinux.old
 --init-partitioned=/dev/sda
@@ -53,7 +53,7 @@
 When configuration is done, just run <c>palo</c>.
 </p>
 
-<pre caption = "Applying the PALO configuration">
+<pre caption="Applying the PALO configuration">
 # <i>palo</i>
 </pre>
 



1.27                 xml/htdocs/doc/en/handbook/hb-install-hppa-disk.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-disk.xml?rev=1.27&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-disk.xml?rev=1.27&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-disk.xml?r1=1.26&r2=1.27

Index: hb-install-hppa-disk.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-disk.xml,v
retrieving revision 1.26
retrieving revision 1.27
diff -u -r1.26 -r1.27
--- hb-install-hppa-disk.xml	26 Jan 2009 08:04:26 -0000	1.26
+++ hb-install-hppa-disk.xml	20 Jul 2010 00:05:24 -0000	1.27
@@ -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/hb-install-hppa-disk.xml,v 1.26 2009/01/26 08:04:26 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-disk.xml,v 1.27 2010/07/20 00:05:24 nightmorph Exp $ -->
 
 <sections>
 
-<version>9.1</version>
-<date>2008-04-01</date>
+<version>10.0</version>
+<date>2010-07-19</date>
 
 <section>
 <title>Introduction to Block Devices</title>
@@ -124,7 +124,7 @@
 unable to read a kernel after the 2GB limit.
 </impo>
 
-<pre caption="A simple default partition schema">
+<pre caption="A simple default partition scheme">
 # <i>cat /etc/fstab</i>
 /dev/sda2    /boot   ext3    noauto,noatime   1 1
 /dev/sda3    none    swap    sw               0 0



1.47                 xml/htdocs/doc/en/handbook/hb-install-hppa-kernel.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-kernel.xml?rev=1.47&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-kernel.xml?rev=1.47&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-kernel.xml?r1=1.46&r2=1.47

Index: hb-install-hppa-kernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-kernel.xml,v
retrieving revision 1.46
retrieving revision 1.47
diff -u -r1.46 -r1.47
--- hb-install-hppa-kernel.xml	1 Apr 2008 08:53:46 -0000	1.46
+++ hb-install-hppa-kernel.xml	20 Jul 2010 00:05:24 -0000	1.47
@@ -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/hb-install-hppa-kernel.xml,v 1.46 2008/04/01 08:53:46 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-kernel.xml,v 1.47 2010/07/20 00:05:24 nightmorph Exp $ -->
 
 <sections>
 
-<version>9.0</version>
-<date>2008-04-01</date>
+<version>10.0</version>
+<date>2010-07-19</date>
 
 <section>
 <title>Timezone</title>
@@ -47,7 +47,12 @@
 </p>
 
 <p>
-For HPPA we have <c>gentoo-sources</c>.
+For <keyval id="arch"/>-based systems we have <c>gentoo-sources</c>
+(kernel source patched for extra features).
+</p>
+
+<p>
+Choose your kernel source and install it using <c>emerge</c>.
 </p>
 
 <pre caption="Installing a kernel source">
@@ -57,8 +62,8 @@
 <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>hppa-sources-<keyval id="kernel-version"/></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">
@@ -220,7 +225,7 @@
 </pre>
 
 <p>
-When you're done configuring your kernel, continue with <uri
+When you've finished configuring the kernel, continue with <uri 
 link="#compiling">Compiling and Installing</uri>.
 </p>
 
@@ -250,12 +255,12 @@
 When the kernel has finished compiling, copy the kernel image to
 <path>/boot</path>. Use whatever name you feel is appropriate for your kernel
 choice and remember it as you will need it later on when you configure your
-bootloader. Remember to replace <path>&lt;kernel-version&gt;</path> with the
+bootloader. Remember to replace <c><keyval id="kernel-name"/></c> with the
 name and version of your kernel.
 </p>
 
 <pre caption="Installing the kernel">
-# <i>cp vmlinux /boot/&lt;kernel-version&gt;</i>
+# <i>cp vmlinux /boot/<keyval id="kernel-name"/></i>
 </pre>
 
 <p>



1.52                 xml/htdocs/doc/en/handbook/hb-install-hppa-medium.xml

file : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-medium.xml?rev=1.52&view=markup
plain: http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-medium.xml?rev=1.52&content-type=text/plain
diff : http://sources.gentoo.org/viewvc.cgi/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-medium.xml?r1=1.51&r2=1.52

Index: hb-install-hppa-medium.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-medium.xml,v
retrieving revision 1.51
retrieving revision 1.52
diff -u -r1.51 -r1.52
--- hb-install-hppa-medium.xml	26 Jan 2009 07:51:05 -0000	1.51
+++ hb-install-hppa-medium.xml	20 Jul 2010 00:05:24 -0000	1.52
@@ -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/hb-install-hppa-medium.xml,v 1.51 2009/01/26 07:51:05 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-medium.xml,v 1.52 2010/07/20 00:05:24 nightmorph Exp $ -->
 
 <sections>
 
-<version>9.3</version>
-<date>2009-01-25</date>
+<version>10.0</version>
+<date>2010-07-19</date>
 
 <section>
 <title>Hardware Requirements</title>
@@ -78,18 +78,17 @@
 
 <p>
 All Installation CDs allow you to boot, set up networking, initialize your
-partitions and start installing Gentoo from the Internet. We currently provide
-two Installation CDs which are equally suitable to install Gentoo from, as long 
-as you're planning on performing an Internet-based installation using the 
-latest version of the available packages.
+partitions and start installing Gentoo from the Internet.
 </p>
 
-<p>
+<!--
+<impo>
 If you wish to install Gentoo without a working Internet connection, please use
 the installation instructions described in the <uri
 link="2008.0/index.xml">Gentoo 2008.0 Handbooks</uri>.
-</p>
-
+</impo>
+-->
+<!--
 <p>
 The two Installation CDs that we currently provide are:
 </p>
@@ -111,7 +110,7 @@
 To help you decide which Installation CD you need, we have written down the 
 major advantages and disadvantages of each Installation CD.
 </p>
-
+-->
 </body>
 </subsection>
 <subsection>
@@ -119,11 +118,12 @@
 <body>
 
 <p>
-The Minimal Installation CD is called <c><keyval id="min-cd-name"/></c> 
-and takes up only 75 MB of diskspace. You can use this Installation CD to 
-install Gentoo, but always with a working Internet connection only.
+The Minimal Installation CD is called <c><keyval id="min-cd-name"/></c> and
+takes up only <keyval id="min-cd-size"/> MB of diskspace. You can use this
+Installation CD to install Gentoo, but <e>only</e> with a working Internet
+connection.
 </p>
-
+<!--
 <table>
 <tr>
   <th>Minimal Installation CD</th>
@@ -192,7 +192,7 @@
 If you intend to use the Packages CD to quickly install additional software,
 make sure that you use the same subarchitecture as the stage3 tarball you use.
 </p>
-
+-->
 </body>
 </subsection>
 <subsection>
@@ -215,7 +215,7 @@
 </section>
 <!-- STOP -->
 <section>
-<title>Download, Burn and Boot the Gentoo Universal Installation CD</title>
+<title>Download, Burn and Boot a Gentoo Installation CD</title>
 <subsection>
 <title>Downloading and Burning the Installation CD</title>
 <body>
@@ -225,12 +225,13 @@
 downloading and burning the chosen Installation CD. We previously discussed 
 the several available Installation CDs, but where can you find them? 
 </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><keyval id="release-dir"/>installcd</path> 
-directory.
+<!-- note: replace release path with:
+    <path><keyval id="release-dir"/>current-iso/</path>
+as soon as autobuild CDs are available for HPPA -->
+<p>
+You can download any of the Installation CDs from one of our <uri
+link="/main/en/mirrors.xml">mirrors</uri>. The Installation CDs are located in
+the <path>releases/hppa/2008.0/installcd/</path> directory.
 </p>
 
 <p>
@@ -239,36 +240,32 @@
 </p>
 
 <p>
-After downloading the file, you can verify its integrity to see if it is 
-corrupted or not:
+In case you wonder if your downloaded file is corrupted or not, you can check
+its MD5 checksum and compare it with the MD5 checksum we provide (such as
+<path><keyval id="min-cd-name"/>.DIGESTS</path>). You can check the MD5
+checksum with the <c>md5sum</c> tool under Linux/Unix or <uri
+link="http://www.etree.org/md5com.html">md5sum</uri> for Windows.
 </p>
 
-<ul>
-  <li>
-    You can check its MD5 checksum and compare it with the MD5 checksum we 
-    provide (for instance with the <c>md5sum</c> tool under Linux/Unix or 
-    <uri link="http://www.etree.org/md5com.html">md5sum</uri> for Windows)
-  </li>
-  <li>
-    You can verify the cryptographic signature that we provide. You need to
-    obtain the public key we use (17072058) before you proceed though.
-  </li>
-</ul>
-
 <p>
-To fetch our public key using the GnuPG application, run the following command:
+Another way to check the validity of the downloaded file is to use GnuPG to
+verify the cryptographic signature that we provide (the file ending with
+<path>.asc</path>). Download the signature file and obtain the public key:
 </p>
 
 <pre caption="Obtaining the public key">
-$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 17072058</i>
+$ <i>gpg --keyserver subkeys.pgp.net --recv-keys 2D182910</i>
 </pre>
 
 <p>
 Now verify the signature:
 </p>
 
-<pre caption="Verify the cryptographic signature">
-$ <i>gpg --verify &lt;signature file&gt; &lt;downloaded iso&gt;</i>
+<pre caption="Verify the files">
+<comment>(Verify the cryptographic signature)</comment>
+$ <i>gpg --verify &lt;downloaded iso.DIGESTS.asc&gt;</i>
+<comment>(Verify the checksum)</comment>
+$ <i>sha1sum -c &lt;downloaded iso.DIGESTS.asc&gt;</i>
 </pre>
 
 <p>