[gentoo-doc-cvs] cvs commit: hb-install-alpha-kernel.xml

[Xavier Neys]

neysx       06/01/08 14:05:29

  Modified:    xml/htdocs/doc/en/handbook hb-install-alpha-kernel.xml
                        hb-install-amd64-kernel.xml
                        hb-install-hppa-kernel.xml
                        hb-install-mips-kernel.xml
                        hb-install-ppc-kernel.xml
                        hb-install-ppc64-kernel.xml
                        hb-install-sparc-kernel.xml
                        hb-install-x86-kernel.xml
  Log:
  #118031 hb-install-*-kernel.xml files need TLC

Revision  Changes    Path
1.33      +12 -30    xml/htdocs/doc/en/handbook/hb-install-alpha-kernel.xml

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

Index: hb-install-alpha-kernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-kernel.xml,v
retrieving revision 1.32
retrieving revision 1.33
diff -u -r1.32 -r1.33
--- hb-install-alpha-kernel.xml	21 Nov 2005 15:37:12 -0000	1.32
+++ hb-install-alpha-kernel.xml	8 Jan 2006 14:05:29 -0000	1.33
@@ -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-alpha-kernel.xml,v 1.32 2005/11/21 15:37:12 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-alpha-kernel.xml,v 1.33 2006/01/08 14:05:29 neysx Exp $ -->
 
 <sections>
 
-<version>2.10</version>
-<date>2005-11-21</date>
+<version>2.11</version>
+<date>2006-01-06</date>
 
 <section>
 <title>Timezone</title>
@@ -57,16 +57,20 @@
 In the next example we install the <c>vanilla-sources</c>.
 Of course substitute with your choice of sources, this is merely an example.
 The <c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
-dependencies at this point:
+dependencies at this point. <c>USE="symlink"</c> is not necessary for a new
++install, but ensures proper creation of the <path>/usr/src/linux</path>
++symlink.
 </p>
 
 <pre caption="Installing a kernel source">
-# <i>USE="-doc" emerge vanilla-sources</i>
+# <i>USE="-doc symlink" emerge vanilla-sources</i>
 </pre>
 
 <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:
+<path>linux</path> pointing to your kernel source. In this case, the installed
+kernel source points to <c>vanilla-sources-2.6.11.2</c>. Your version may be
+different, so keep this in mind.
 </p>
 
 <pre caption="Viewing the kernel source symlink">
@@ -75,17 +79,6 @@
 </pre>
 
 <p>
-If this isn't the case (i.e. the symlink points to a different kernel source) 
-change the symlink before you continue:
-</p>
-
-<pre caption="Changing the kernel source symlink">
-# <i>rm /usr/src/linux</i>
-# <i>cd /usr/src</i>
-# <i>ln -s linux-2.6.11.2 linux</i>
-</pre>
-
-<p>
 Now it is time to configure and compile your kernel source. You 
 can use <c>genkernel</c> for this, which will build a generic kernel as used 
 by the Installation CD. We explain the "manual" configuration first though, as it is 
@@ -182,7 +175,6 @@
 File systems ---&gt;
   Pseudo Filesystems ---&gt;
     [*] /proc file system support
-    [ ] /dev file system support (OBSOLETE)
     [*] Virtual memory file system support (former shm fs)
 
 <comment>(Select one or more of the following options as needed by your system)</comment>
@@ -311,9 +303,8 @@
 
 <p>
 When the kernel has finished compiling, copy the kernel image to
-<path>/boot</path>. In the next example we assume you have configured and
-compiled <c>vanilla-sources-2.6.11.2</c>; recent kernels might create
-<path>vmlinux</path> instead of <path>vmlinux.gz</path>.
+<path>/boot</path>. Recent kernels might create <path>vmlinux</path> instead of
+<path>vmlinux.gz</path>. Keep this in mind when you copy your kernel image.
 </p>
 
 <pre caption="Installing the kernel">
@@ -321,15 +312,6 @@
 </pre>
 
 <p>
-It is also wise to copy over your kernel configuration file to
-<path>/boot</path>, just in case :)
-</p>
-
-<pre caption="Backing up your kernel configuration">
-# <i>cp .config /boot/config-2.6.11.2</i>
-</pre>
-
-<p>
 Now continue with <uri link="#kernel_modules">Installing Separate Kernel
 Modules</uri>.
 </p>



1.35      +18 -33    xml/htdocs/doc/en/handbook/hb-install-amd64-kernel.xml

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

Index: hb-install-amd64-kernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-amd64-kernel.xml,v
retrieving revision 1.34
retrieving revision 1.35
diff -u -r1.34 -r1.35
--- hb-install-amd64-kernel.xml	27 Nov 2005 01:46:02 -0000	1.34
+++ hb-install-amd64-kernel.xml	8 Jan 2006 14:05:29 -0000	1.35
@@ -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-amd64-kernel.xml,v 1.34 2005/11/27 01:46:02 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-amd64-kernel.xml,v 1.35 2006/01/08 14:05:29 neysx Exp $ -->
 
 <sections>
 
-<version>2.11</version>
-<date>2005-11-26</date>
+<version>2.12</version>
+<date>2006-01-06</date>
 
 <section>
 <title>Timezone</title>
@@ -52,18 +52,22 @@
 </p>
 
 <p>
-Choose your kernel source and install it using <c>emerge</c>. 
-The <c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
-dependencies at this point:
+Choose your kernel source and install it using <c>emerge</c>. The
+<c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
+dependencies at this point. <c>USE="symlink"</c> is not necessary for a new
+install, but ensures proper creation of the <path>/usr/src/linux</path>
+symlink.
 </p>
 
 <pre caption="Installing a kernel source">
-# <i>USE="-doc" emerge gentoo-sources</i>
+# <i>USE="-doc symlink" emerge gentoo-sources</i>
 </pre>
 
 <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:
+<path>linux</path> pointing to your kernel source. In this case, the installed
+kernel source points to <c>gentoo-sources-2.6.12-r10</c>. Your version may be
+different, so keep this in mind.
 </p>
 
 <pre caption="Viewing the kernel source symlink">
@@ -72,17 +76,6 @@
 </pre>
 
 <p>
-If this isn't the case (i.e. the symlink points to a different kernel source) 
-change the symlink before you continue:
-</p>
-
-<pre caption="Changing the kernel source symlink">
-# <i>rm /usr/src/linux</i>
-# <i>cd /usr/src</i>
-# <i>ln -s linux-2.6.12-gentoo-r10 linux</i>
-</pre>
-
-<p>
 Now it is time to configure and compile your kernel source.
 You can use <c>genkernel</c> for this, which will build a generic kernel as used
 by the Installation CD. We explain the "manual" configuration first though, as 
@@ -182,15 +175,13 @@
 Now go to <c>File Systems</c> and select support for the filesystems you use.
 <e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
 able to mount your partitions. Also select <c>Virtual memory</c> and <c>/proc
-file system</c>. Do <e>not</e> select <c>/dev file system support</c> as
-Gentoo/AMD64 now uses <c>udev</c> by default.
+file system</c>.
 </p>
 
 <pre caption="Selecting necessary file systems">
 File systems ---&gt;
   Pseudo Filesystems ---&gt;
     [*] /proc file system support
-    [ ] /dev file system support (OBSOLETE)
     [*] Virtual memory file system support (former shm fs)
 
 <comment>(Select one or more of the following options as needed by your system)</comment>
@@ -269,20 +260,14 @@
 
 <p>
 When the kernel has finished compiling, copy the kernel image to
-<path>/boot</path>:
+<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 name and
+version of your kernel.
 </p>
 
 <pre caption="Installing the kernel">
-# <i>cp arch/x86_64/boot/bzImage /boot/kernel-2.6.12-gentoo-r10</i>
-</pre>
-
-<p>
-It is also wise to copy over your kernel configuration file to
-<path>/boot</path>, just in case :)
-</p>
-
-<pre caption="Backing up your kernel configuration">
-# <i>cp .config /boot/config-2.6.12-gentoo-r10</i>
+# <i>cp arch/x86_64/boot/bzImage /boot/&lt;kernel-version&gt;</i>
 </pre>
 
 <p>



1.30      +22 -38    xml/htdocs/doc/en/handbook/hb-install-hppa-kernel.xml

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

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.29
retrieving revision 1.30
diff -u -r1.29 -r1.30
--- hb-install-hppa-kernel.xml	21 Nov 2005 15:37:12 -0000	1.29
+++ hb-install-hppa-kernel.xml	8 Jan 2006 14:05:29 -0000	1.30
@@ -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.29 2005/11/21 15:37:12 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-hppa-kernel.xml,v 1.30 2006/01/08 14:05:29 neysx Exp $ -->
 
 <sections>
 
-<version>1.22</version>
-<date>2005-11-21</date>
+<version>1.23</version>
+<date>2006-01-06</date>
 
 <section>
 <title>Timezone</title>
@@ -46,21 +46,25 @@
 </p>
 
 <p>
-For HPPA we have <c>hppa-sources</c>. Default these sources are based on
-the 2.6 kernel sources. If you want to install a 2.4 kernel, you will need
-to install Gentoo from a working Internet connection as we do not supply those
-sources on our Installation CD. Continue by installing the kernel source.
-The <c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
-dependencies at this point:
+For HPPA we have <c>hppa-sources</c>. By default, these sources are based on
+the 2.6 kernel sources. If you want to install a 2.4 kernel, you will need to
+install Gentoo from a working Internet connection as we do not supply those
+sources on our Installation CD. Continue by installing the kernel source.  The
+<c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
+dependencies at this point. <c>USE="symlink"</c> is not necessary for a new
+install, but ensures proper creation of the <path>/usr/src/linux</path>
+symlink.
 </p>
 
 <pre caption="Installing a kernel source">
-# <i>USE="-doc" emerge hppa-sources</i>
+# <i>USE="-doc symlink" emerge hppa-sources</i>
 </pre>
 
 <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:
+<path>linux</path> pointing to your kernel source. In this case, the installed
+kernel source points to <c>hppa-sources-2.6.12.2-pa2</c>. Your version may be
+different, so keep this in mind.
 </p>
 
 <pre caption="Viewing the kernel source symlink">
@@ -69,17 +73,6 @@
 </pre>
 
 <p>
-If this isn't the case (i.e. the symlink points to a different kernel source) 
-change the symlink before you continue:
-</p>
-
-<pre caption="Changing the kernel source symlink">
-# <i>rm /usr/src/linux</i>
-# <i>cd /usr/src</i>
-# <i>ln -s linux-2.6.12.2-pa2 linux</i>
-</pre>
-
-<p>
 Now it is time to configure and compile your kernel source. All architectures 
 can use <c>genkernel</c> for this, which will build a generic kernel as used 
 by the Installation CD. We explain the "manual" configuration first though, as
@@ -157,16 +150,14 @@
 <p>
 Now go to <c>File Systems</c> and select support for the filesystems you use.
 <e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
-able to mount your partitions. Also select <c>Virtual memory</c>, <c>/proc
-file system</c>, <c>/dev file system</c> + <c>Automatically mount at boot</c>:
+able to mount your partitions. Also select <c>Virtual memory</c> and <c>/proc
+file system</c>:
 </p>
 
 <pre caption="Selecting necessary file systems">
 File systems ---&gt;
   Pseudo Filesystems ---&gt;
     [*] /proc file system support
-    [*] /dev file system support (OBSOLETE)
-    [*]   Automatically mount at boot
     [*] Virtual memory file system support (former shm fs)
 
 <comment>(Select one or more of the following options as needed by your system)</comment>
@@ -268,21 +259,14 @@
 
 <p>
 When the kernel has finished compiling, copy the kernel image to
-<path>/boot</path>. In the next example we assume you have configured and
-compiled <c>hppa-sources-2.6.12.2-pa2</c>.
+<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
+name and version of your kernel.
 </p>
 
 <pre caption="Installing the kernel">
-# <i>cp vmlinux /boot/kernel-2.6.12.2-pa2</i>
-</pre>
-
-<p>
-It is also wise to copy over your kernel configuration file to
-<path>/boot</path>, just in case :)
-</p>
-
-<pre caption="Backing up your kernel configuration">
-# <i>cp .config /boot/config-2.6.12.2-pa2</i>
+# <i>cp vmlinux /boot/&lt;kernel-version&gt;</i>
 </pre>
 
 <p>



1.19      +20 -34    xml/htdocs/doc/en/handbook/hb-install-mips-kernel.xml

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

Index: hb-install-mips-kernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-kernel.xml,v
retrieving revision 1.18
retrieving revision 1.19
diff -u -r1.18 -r1.19
--- hb-install-mips-kernel.xml	21 Nov 2005 15:37:12 -0000	1.18
+++ hb-install-mips-kernel.xml	8 Jan 2006 14:05:29 -0000	1.19
@@ -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-mips-kernel.xml,v 1.18 2005/11/21 15:37:12 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-mips-kernel.xml,v 1.19 2006/01/08 14:05:29 neysx Exp $ -->
 
 <sections>
 
-<version>1.14</version>
-<date>2005-11-21</date>
+<version>1.15</version>
+<date>2006-01-06</date>
 
 <section>
 <title>Timezone</title>
@@ -50,10 +50,12 @@
 </p>
 
 <p>
-Choose your kernel source and install it using <c>emerge</c>. 
-Of course substitute with your choice of sources, this is merely an example.
-The <c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
-dependencies at this point:
+Choose your kernel source and install it using <c>emerge</c>.  Of course
+substitute with your choice of sources, this is merely an example.  The
+<c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
+dependencies at this point. <c>USE="symlink"</c> is not necessary for a new
+install, but ensures proper creation of the <path>/usr/src/linux</path>
+symlink.
 </p>
 
 <note>
@@ -64,17 +66,19 @@
 
 <pre caption="Installing a kernel source">
 <comment>(For SGI machines)</comment>
-# <i>USE="-doc" emerge mips-sources</i>
+# <i>USE="-doc symlink" emerge mips-sources</i>
 
 <comment>(For Cobalt machines)</comment>
 # <i>mkdir -p /etc/portage</i>
 # <i>echo "sys-kernel/mips-sources cobalt" &gt;&gt; /etc/portage/package.use</i>
-# <i>USE="-doc" emerge mips-sources</i>
+# <i>USE="-doc symlink" emerge mips-sources</i>
 </pre>
 
 <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:
+<path>linux</path> pointing to your kernel source. In this case, the installed
+kernel source points to <c>mips-sources-2.4.24</c>. Your version may be
+different, so keep this in mind.
 </p>
 
 <pre caption="Viewing the kernel source symlink">
@@ -83,17 +87,6 @@
 </pre>
 
 <p>
-If this isn't the case (i.e. the symlink points to a different kernel source) 
-change the symlink before you continue:
-</p>
-
-<pre caption="Changing the kernel source symlink">
-# <i>rm /usr/src/linux</i>
-# <i>cd /usr/src</i>
-# <i>ln -s linux-2.4.24 linux</i>
-</pre>
-
-<p>
 Now it is time to configure and compile your kernel source. 
 </p>
 
@@ -196,23 +189,16 @@
 </p>
 
 <note>
-On Cobalt servers, the bootloader will expect to see a compressed kernelimage.
-Remember to <c>gzip -9</c> the file once it is in <path>/boot</path>.
+On Cobalt servers, the bootloader will expect to see a compressed kernel image.
+Remember to <c>gzip -9</c> the file once it is in <path>/boot</path>. In the
+following example, replace <path>&lt;kernel-version&gt;</path> with your kernel
+version.
 </note>
 
 <pre caption="Installing the kernel">
-# <i>cp vmlinux /boot/kernel-2.4.24</i>
+# <i>cp vmlinux /boot/&lt;kernel-version&lt;</i>
 <comment>(Cobalt Servers -- Compressing the kernel image)</comment>
-# <i>gzip -9v /boot/kernel-2.4.24</i>
-</pre>
-
-<p>
-It is also wise to copy over your kernel configuration file to
-<path>/boot</path>, just in case :)
-</p>
-
-<pre caption="Backing up your kernel configuration">
-# <i>cp .config /boot/config-2.4.24</i>
+# <i>gzip -9v /boot/&lt;kernel-version&lt;</i>
 </pre>
 
 <!--



1.38      +23 -40    xml/htdocs/doc/en/handbook/hb-install-ppc-kernel.xml

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

Index: hb-install-ppc-kernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-kernel.xml,v
retrieving revision 1.37
retrieving revision 1.38
diff -u -r1.37 -r1.38
--- hb-install-ppc-kernel.xml	21 Nov 2005 15:37:12 -0000	1.37
+++ hb-install-ppc-kernel.xml	8 Jan 2006 14:05:29 -0000	1.38
@@ -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-ppc-kernel.xml,v 1.37 2005/11/21 15:37:12 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc-kernel.xml,v 1.38 2006/01/08 14:05:29 neysx Exp $ -->
 
 <sections>
 
-<version>2.14</version>
-<date>2005-11-21</date>
+<version>2.15</version>
+<date>2006-01-06</date>
 
 <section>
 <title>Timezone</title>
@@ -46,27 +46,32 @@
 </p>
 
 <p>
-We suggest using either <c>vanilla-sources</c> or <c>gentoo-sources</c> 
-on PPC, which are both 2.6 kernels. The latter is available when you
-perform a networkless installation. So let's continue with <c>emerge</c>'ing 
-the kernel sources.
-The <c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
-dependencies at this point:
+We suggest using either <c>vanilla-sources</c> or <c>gentoo-sources</c> on PPC,
+which are both 2.6 kernels. The latter is available when you perform a
+networkless installation. So let's continue with <c>emerge</c>'ing the kernel
+sources. The <c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or
+other dependencies at this point. <c>USE="symlink"</c> is not necessary for a
+new install, but ensures proper creation of the <path>/usr/src/linux</path>
+symlink.
 </p>
 
 <pre caption="Installing the kernel source">
-# <i>USE="-doc" emerge gentoo-sources</i>
+# <i>USE="-doc symlink" emerge gentoo-sources</i>
 </pre>
 
+<!-- Removed, as we're trying to avoid specific kernel versions to improve HB
+maintainability
 <note>
-The suggested sources at the time of the 2005.1 release are 
+The suggested sources at the time of the 2005.1 release are
 <c>gentoo-sources-2.6.12-r4</c> and <c>vanilla-sources-2.6.12.2</c>.
-</note>
+</note> 
+-->
 
 <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. Here, we will assume
-that the kernel source installed is <c>gentoo-sources-2.6.12-r4</c>:
+<path>linux</path> pointing to your current kernel source. In this case, the
+installed kernel source points to <c>gentoo-sources-2.6.12-r4</c>. Your version
+may be different, so keep this in mind.
 </p>
 
 <pre caption="Viewing the kernel source symlink">
@@ -75,18 +80,6 @@
 </pre>
 
 <p>
-If the symlink doesn't point to the kernel source of your choice (note that
-<c>linux-2.6.12-gentoo-r4</c> is merely an example) you should change it to the
-desired kernel sources:
-</p>
-
-<pre caption="Changing the kernel source symlink">
-# <i>rm /usr/src/linux</i>
-# <i>cd /usr/src</i>
-# <i>ln -s linux-2.6.12-gentoo-r4 linux</i>
-</pre>
-
-<p>
 It is now time to configure and compile your kernel source. You can use 
 <c>genkernel</c> to build a generic kernel similar to the one used by the 
 Installation CD, or you can perform a manual configuration to best suit your
@@ -172,14 +165,13 @@
 Now go to <c>File Systems</c> and select support for the filesystems you use.
 <e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
 able to mount your partitions. Also select <c>/proc file system</c> and
-<c>Virtual memory</c>. Do <e>not</e> select the <c>/dev file system</c>.
+<c>Virtual memory</c>.
 </p>
 
 <pre caption="Selecting necessary file systems">
 File systems ---&gt;
   Pseudo Filesystems ---&gt;
     [*] /proc file system support
-    [ ] /dev file system support (OBSOLETE)
     [*] Virtual memory file system support (former shm fs)
 
 <comment>(Select one or more of the following options as needed by your system)</comment>
@@ -315,18 +307,9 @@
 </p>
 
 <pre caption="Installing the kernel">
-<comment>replace 2.6.12 with your kernel-version</comment>
-(Apple/IBM)  # <i>cp vmlinux /boot/kernel-2.6.12</i>
-(Pegasos)    # <i>cp arch/ppc/boot/images/zImage.chrp /boot/kernel-2.6.12</i>
-</pre>
-
-<p>
-It is also wise to copy over your kernel configuration file to
-<path>/boot</path>, just in case :)
-</p>
-
-<pre caption="Backing up your kernel configuration">
-# <i>cp .config /boot/config-2.6.12-gentoo-r4</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>
 </pre>
 
 <p>



1.22      +19 -39    xml/htdocs/doc/en/handbook/hb-install-ppc64-kernel.xml

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

Index: hb-install-ppc64-kernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-kernel.xml,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- hb-install-ppc64-kernel.xml	24 Nov 2005 17:26:10 -0000	1.21
+++ hb-install-ppc64-kernel.xml	8 Jan 2006 14:05:29 -0000	1.22
@@ -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-ppc64-kernel.xml,v 1.21 2005/11/24 17:26:10 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-ppc64-kernel.xml,v 1.22 2006/01/08 14:05:29 neysx Exp $ -->
 
 <sections>
 
-<version>2.9</version>
-<date>2005-11-24</date>
+<version>2.10</version>
+<date>2006-01-06</date>
 
 <section>
 <title>Timezone</title>
@@ -47,18 +47,21 @@
 
 <p>
 For PPC64 you should use <c>gentoo-sources</c>. So let's continue with
-<c>emerge</c>'ing the kernel sources.
-The <c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
-dependencies at this point:
+<c>emerge</c>'ing the kernel sources. The <c>USE="-doc"</c> is necessary to
+avoid installing xorg-x11 or other dependencies at this point.
+<c>USE="symlink"</c> is not necessary for a new install, but ensures proper
+creation of the <path>/usr/src/linux</path> symlink.
 </p>
 
 <pre caption="Installing a kernel source">
-# <i>USE="-doc" emerge gentoo-sources</i>
+# <i>USE="-doc symlink" emerge gentoo-sources</i>
 </pre>
 
 <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:
+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.12-r10</c>. Your version may be
+different, so keep this in mind.
 </p>
 
 <pre caption="Viewing the kernel source symlink">
@@ -67,17 +70,6 @@
 </pre>
 
 <p>
-If this isn't the case (i.e. the symlink points to a different kernel
-source) change the symlink before you continue:
-</p>
-
-<pre caption="Changing the kernel source symlink">
-# <i>rm /usr/src/linux</i>
-# <i>cd /usr/src</i>
-# <i>ln -s linux-2.6.12-gentoo-r10 linux</i>
-</pre>
-
-<p>
 Now it is time to configure and compile your kernel source. There is the
 ability to use "genkernel" which would create a generic kernel like the
 ones used on the installation CDs, but it is not fully functional for PPC64 at
@@ -151,20 +143,16 @@
 </pre>
 
 <p>
-Now go to <c>File Systems</c> and select support for the filesystems you
-use. <e>Don't</e> compile them as modules, otherwise your Gentoo system
-will not be able to mount your partitions. Also select <c>Virtual
-memory</c>, <c>/proc file system</c>, <c>/dev file system</c> +
-<c>Automatically mount at boot</c> and <c>/dev/pts file system for
-Unix98 PTYs</c>:
+Now go to <c>File Systems</c> and select support for the filesystems you use.
+<e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
+able to mount your partitions. Also select <c>Virtual memory</c>, <c>/proc file
+system</c>, and <c>/dev/pts file system for Unix98 PTYs</c>:
 </p>
 
 <pre caption="Selecting necessary file systems">
 File systems ---&gt;
   [*] Virtual memory file system support (former shm fs)
   [*] /proc file system support
-  [*] /dev file system support (EXPERIMENTAL)
-  [*]   Automatically mount at boot
   [*] /dev/pts file system for Unix98 PTYs
 
 <comment>(Select one or more of the following options as needed by your system)</comment>
@@ -236,20 +224,12 @@
 
 <p>
 When the kernel has finished compiling, copy the kernel image to
-<path>/boot</path>. 
+<path>/boot</path>. Remember to replace <path>&lt;kernel-version&lt;</path>
+with your actual kernel version:
 </p>
 
 <pre caption="Installing the kernel">
-(Apple/IBM)  # <i>cp vmlinux /boot/kernel-2.6.12-gentoo-r10</i>
-</pre>
-
-<p>
-It is also wise to copy over your kernel configuration file to
-<path>/boot</path>, just in case :)
-</p>
-
-<pre caption="Backing up your kernel configuration">
-# <i>cp .config /boot/config-2.6.12-gentoo-r10</i>
+(Apple/IBM)  # <i>cp vmlinux /boot/&lt;kernel-version&gt;</i>
 </pre>
 
 <p>



1.22      +21 -38    xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml

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

Index: hb-install-sparc-kernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -r1.21 -r1.22
--- hb-install-sparc-kernel.xml	24 Nov 2005 17:26:10 -0000	1.21
+++ hb-install-sparc-kernel.xml	8 Jan 2006 14:05:29 -0000	1.22
@@ -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-sparc-kernel.xml,v 1.21 2005/11/24 17:26:10 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-sparc-kernel.xml,v 1.22 2006/01/08 14:05:29 neysx Exp $ -->
 
 <sections>
 
-<version>2.6</version>
-<date>2005-11-24</date>
+<version>2.7</version>
+<date>2006-01-06</date>
 
 <section>
 <title>Timezone</title>
@@ -56,19 +56,22 @@
 </p>
 
 <p>
-In the next example we install the <c>sparc-sources</c>.
-Of course substitute with your choice of sources, this is merely an example.
-The <c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
-dependencies at this point:
+In the next example we install the <c>sparc-sources</c>.  Of course substitute
+with your choice of sources, this is merely an example.  The <c>USE="-doc"</c>
+is necessary to avoid installing xorg-x11 or other dependencies at this point.
+<c>USE="symlink"</c> is not necessary for a new install, but ensures proper
+creation of the <path>/usr/src/linux</path> symlink.
 </p>
 
 <pre caption="Installing a kernel source">
-# <i>USE="-doc" emerge sparc-sources</i>
+# <i>USE="-doc symlink" emerge sparc-sources</i>
 </pre>
 
 <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:
+<path>linux</path> pointing to your kernel source. In this case, the installed
+kernel source points to <c>sparc-sources-2.4.31</c>. Your version may be
+different, so keep this in mind.
 </p>
 
 <pre caption="Viewing the kernel source symlink">
@@ -77,17 +80,6 @@
 </pre>
 
 <p>
-If this isn't the case (i.e. the symlink points to a different kernel source) 
-change the symlink before you continue:
-</p>
-
-<pre caption="Changing the kernel source symlink">
-# <i>rm /usr/src/linux</i>
-# <i>cd /usr/src</i>
-# <i>ln -s linux-2.4.31-sparc linux</i>
-</pre>
-
-<p>
 Now it is time to configure and compile your kernel source. 
 </p>
 
@@ -153,8 +145,9 @@
 <p>
 Now go to <c>File Systems</c> and select support for the filesystems you use.
 <e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
-able to mount your partitions. Also select <c>Virtual memory</c>, <c>/proc
-file system</c>, <c>/dev file system</c> + <c>Automatically mount at boot</c>:
+able to mount your partitions. Also select <c>Virtual memory</c> and <c>/proc
+file system</c>. If you are running a 2.4 kernel, you should also select
+<c>/dev file system</c> + <c>Automatically mount at boot</c>:
 </p>
 
 <pre caption="Selecting necessary file systems">
@@ -170,8 +163,6 @@
 File systems ---&gt;
   Pseudo Filesystems ---&gt;
     [*] /proc file system support
-    [*] /dev file system support (OBSOLETE)
-    [*]   Automatically mount at boot
     [*] Virtual memory file system support (former shm fs)
 
 <comment>(Select one or more of the following options as needed by your system)</comment>
@@ -324,30 +315,22 @@
 
 <p>
 When the kernel has finished compiling, copy the kernel image to
-<path>/boot</path>.
+<path>/boot</path>. Remember to replace <path>&lt;kernel-version&gt;</path>
+with your actual kernel version.
 </p>
 
 <pre caption="Installing the kernel">
 <comment>(For 2.4 kernel, sparc32)</comment>
-# <i>cp vmlinux /boot/kernel-2.4.29</i>
+# <i>cp vmlinux /boot/&lt;kernel-version&gt;</i>
 
 <comment>(For 2.4 kernel, sparc64)</comment>
-# <i>cp arch/sparc64/boot/image /boot/kernel-2.4.31</i>
+# <i>cp arch/sparc64/boot/image /boot/&lt;kernel-version&gt;</i>
 
 <comment>(For 2.6 kernel, sparc32)</comment>
-# <i>cp arch/sparc/boot/image /boot/kernel-2.6.11</i>
+# <i>cp arch/sparc/boot/image /boot/&lt;kernel-version&gt;</i>
 
 <comment>(For 2.6 kernel, sparc64)</comment>
-# <i>cp arch/sparc64/boot/image /boot/kernel-2.6.11</i>
-</pre>
-
-<p>
-It is also wise to copy over your kernel configuration file to
-<path>/boot</path>, just in case :)
-</p>
-
-<pre caption="Backing up your kernel configuration">
-# <i>cp .config /boot/config-2.4.31</i>
+# <i>cp arch/sparc64/boot/image /boot/&lt;kernel-version&gt;</i>
 </pre>
 
 <p>



1.60      +19 -40    xml/htdocs/doc/en/handbook/hb-install-x86-kernel.xml

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

Index: hb-install-x86-kernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86-kernel.xml,v
retrieving revision 1.59
retrieving revision 1.60
diff -u -r1.59 -r1.60
--- hb-install-x86-kernel.xml	12 Dec 2005 15:53:35 -0000	1.59
+++ hb-install-x86-kernel.xml	8 Jan 2006 14:05:29 -0000	1.60
@@ -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-x86-kernel.xml,v 1.59 2005/12/12 15:53:35 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/hb-install-x86-kernel.xml,v 1.60 2006/01/08 14:05:29 neysx Exp $ -->
 
 <sections>
 
-<version>3.10</version>
-<date>2005-12-12</date>
+<version>3.11</version>
+<date>2006-01-06</date>
 
 <section>
 <title>Timezone</title>
@@ -53,19 +53,22 @@
 </p>
 
 <p>
-Choose your kernel source and install it using <c>emerge</c>. 
-The <c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
-dependencies at this point:
+Choose your kernel source and install it using <c>emerge</c>. The
+<c>USE="-doc"</c> is necessary to avoid installing xorg-x11 or other
+dependencies at this point. <c>USE="symlink"</c> is not necessary for a new
+install, but ensures proper creation of the <path>/usr/src/linux</path>
+symlink.
 </p>
 
 <pre caption="Installing a kernel source">
-# <i>USE="-doc" emerge gentoo-sources</i>
+# <i>USE="-doc symlink" emerge gentoo-sources</i>
 </pre>
 
 <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. We will assume the kernel
-source installed is <c>gentoo-sources-2.6.12-r10</c>:
+<path>linux</path> pointing to your kernel source. In this case, the installed
+kernel source points to <c>gentoo-sources-2.6.12-r10</c>. Your version may be
+different, so keep this in mind.
 </p>
 
 <pre caption="Viewing the kernel source symlink">
@@ -74,18 +77,6 @@
 </pre>
 
 <p>
-If the symlink doesn't point to the kernel source of your choice (note that
-<c>linux-2.6.12-gentoo-r10</c> is merely an example) you should change it to the
-right kernel:
-</p>
-
-<pre caption="Changing the kernel source symlink">
-# <i>rm /usr/src/linux</i>
-# <i>cd /usr/src</i>
-# <i>ln -s linux-2.6.12-gentoo-r10 linux</i>
-</pre>
-
-<p>
 Now it is time to configure and compile your kernel source. You 
 can use <c>genkernel</c> for this, which will build a generic kernel as used 
 by the Installation CD. We explain the "manual" configuration first though, as 
@@ -180,10 +171,8 @@
 Now go to <c>File Systems</c> and select support for the filesystems you use.
 <e>Don't</e> compile them as modules, otherwise your Gentoo system will not be
 able to mount your partitions. Also select <c>Virtual memory</c> and <c>/proc
-file system</c>. If you are using a 2.6 kernel (default), do <e>not</e> select
-the <c>/dev file system</c>, Gentoo/x86 uses <c>udev</c> by default now. If you
-are using a 2.4 kernel, you still need to select <c>/dev file system</c> though
-as 2.4 kernels do not support <c>udev</c>.
+file system</c>. If you are using a 2.4 kernel, you need to select <c>/dev file
+system</c> as 2.4 kernels do not support <c>udev</c>.
 </p>
 
 <pre caption="Selecting necessary file systems">
@@ -199,7 +188,6 @@
 File systems ---&gt;
   Pseudo Filesystems ---&gt;
     [*] /proc file system support
-    [ ] /dev file system support (OBSOLETE)
     [*] Virtual memory file system support (former shm fs)
 
 <comment>(Select one or more of the following options as needed by your system)</comment>
@@ -341,23 +329,14 @@
 
 <p>
 When the kernel has finished compiling, copy the kernel image to
-<path>/boot</path>. From here onwards we assume that the kernel you are
-installing is the 2.6.12-r10 version of the <c>gentoo-sources</c>. Use whatever 
-name you feel is appropriate for your choice and remember it as you will need it
-later on when you configure your bootloader.
+<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 name and
+version of your kernel.
 </p>
 
 <pre caption="Installing the kernel">
-# <i>cp arch/i386/boot/bzImage /boot/kernel-2.6.12-gentoo-r10</i>
-</pre>
-
-<p>
-It is also wise to copy over your kernel configuration file to
-<path>/boot</path>, just in case :)
-</p>
-
-<pre caption="Backing up your kernel configuration">
-# <i>cp .config /boot/config-2.6.12-gentoo-r10</i>
+# <i>cp arch/i386/boot/bzImage /boot/&lt;kernel-version&gt;</i>
 </pre>
 
 <p>



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