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

[Xavier Neys]

neysx       06/01/08 14:05:30

  Modified:    xml/htdocs/doc/en/handbook/2005.1
                        hb-install-alpha-kernel.xml
                        hb-install-amd64-kernel.xml
                        hb-install-hppa-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.7       +14 -32    xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-kernel.xml

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

Index: hb-install-alpha-kernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-kernel.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- hb-install-alpha-kernel.xml	21 Nov 2005 15:37:13 -0000	1.6
+++ hb-install-alpha-kernel.xml	8 Jan 2006 14:05:30 -0000	1.7
@@ -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/2005.1/hb-install-alpha-kernel.xml,v 1.6 2005/11/21 15:37:13 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-alpha-kernel.xml,v 1.7 2006/01/08 14:05:30 neysx Exp $ -->
 
 <sections>
 
-<version>5.4</version>
-<date>2005-11-21</date>
+<version>5.5</version>
+<date>2006-01-06</date>
 
 <section>
 <title>Timezone</title>
@@ -50,9 +50,11 @@
 </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>
 
 <p>
@@ -61,12 +63,14 @@
 </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 
@@ -175,7 +168,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>
@@ -304,9 +296,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">
@@ -314,15 +305,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.7       +18 -33    xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-kernel.xml

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

Index: hb-install-amd64-kernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-kernel.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- hb-install-amd64-kernel.xml	24 Nov 2005 17:26:11 -0000	1.6
+++ hb-install-amd64-kernel.xml	8 Jan 2006 14:05:30 -0000	1.7
@@ -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/2005.1/hb-install-amd64-kernel.xml,v 1.6 2005/11/24 17:26:11 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-amd64-kernel.xml,v 1.7 2006/01/08 14:05:30 neysx Exp $ -->
 
 <sections>
 
-<version>5.4</version>
-<date>2005-11-24</date>
+<version>5.5</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 
@@ -173,15 +166,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</c> since 2005.1/AMD64
-uses <c>udev</c> by default.
+file system</c>.
 </p>
 
 <pre caption="Selecting necessary file systems">
 File systems ---&gt;
   Pseudo Filesystems ---&gt;
     &lt;*&gt; /proc file system support
-    &lt; &gt; /dev file system support (OBSOLETE)
     &lt;*&gt; Virtual memory file system support (former shm fs)
 
 
@@ -261,20 +252,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.7       +22 -38    xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-kernel.xml

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

Index: hb-install-hppa-kernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-kernel.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- hb-install-hppa-kernel.xml	21 Nov 2005 15:37:13 -0000	1.6
+++ hb-install-hppa-kernel.xml	8 Jan 2006 14:05:30 -0000	1.7
@@ -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/2005.1/hb-install-hppa-kernel.xml,v 1.6 2005/11/21 15:37:13 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-hppa-kernel.xml,v 1.7 2006/01/08 14:05:30 neysx Exp $ -->
 
 <sections>
 
-<version>5.4</version>
-<date>2005-11-21</date>
+<version>5.5</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>. 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.8       +21 -38    xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-kernel.xml

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

Index: hb-install-ppc-kernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-kernel.xml,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- hb-install-ppc-kernel.xml	21 Nov 2005 15:37:13 -0000	1.7
+++ hb-install-ppc-kernel.xml	8 Jan 2006 14:05:30 -0000	1.8
@@ -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/2005.1/hb-install-ppc-kernel.xml,v 1.7 2005/11/21 15:37:13 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc-kernel.xml,v 1.8 2006/01/08 14:05:30 neysx Exp $ -->
 
 <sections>
 
-<version>5.3</version>
-<date>2005-11-21</date>
+<version>5.4</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 a 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 
 <c>gentoo-sources-2.6.12-r6</c> and <c>vanilla-sources-2.6.12.2</c>.
 </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-r6</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-r6</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-r6</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-r6 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
@@ -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-r6</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.6       +15 -31    xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc64-kernel.xml

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

Index: hb-install-ppc64-kernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc64-kernel.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- hb-install-ppc64-kernel.xml	24 Nov 2005 17:26:11 -0000	1.5
+++ hb-install-ppc64-kernel.xml	8 Jan 2006 14:05:30 -0000	1.6
@@ -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/2005.1/hb-install-ppc64-kernel.xml,v 1.5 2005/11/24 17:26:11 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-ppc64-kernel.xml,v 1.6 2006/01/08 14:05:30 neysx Exp $ -->
 
 <sections>
 
-<version>5.4</version>
-<date>2005-11-24</date>
+<version>5.5</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
@@ -245,20 +237,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">
-# <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>
+# <i>cp vmlinux /boot/&lt;kernel-version&lt;</i>
 </pre>
 
 <p>



1.7       +19 -40    xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-kernel.xml

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

Index: hb-install-sparc-kernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-kernel.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- hb-install-sparc-kernel.xml	24 Nov 2005 17:26:11 -0000	1.6
+++ hb-install-sparc-kernel.xml	8 Jan 2006 14:05:30 -0000	1.7
@@ -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/2005.1/hb-install-sparc-kernel.xml,v 1.6 2005/11/24 17:26:11 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-sparc-kernel.xml,v 1.7 2006/01/08 14:05:30 neysx Exp $ -->
 
 <sections>
 
-<version>5.4</version>
-<date>2005-11-24</date>
+<version>5.5</version>
+<date>2006-01-06</date>
 
 <section>
 <title>Timezone</title>
@@ -52,23 +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:
-</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:
+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 +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.4.31-sparc linux</i>
-</pre>
-
-<p>
 Now it is time to configure and compile your kernel source. 
 </p>
 
@@ -153,16 +141,15 @@
 <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">
 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>
@@ -289,24 +276,16 @@
 
 <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>(sparc32)</comment>
-# <i>cp vmlinux /boot/kernel-2.4.31</i>
+# <i>cp vmlinux /boot/&lt;kernel-version&gt;</i>
 
 <comment>(sparc64)</comment>
-# <i>cp arch/sparc64/boot/image /boot/kernel-2.4.31</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.7       +18 -37    xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-kernel.xml

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

Index: hb-install-x86-kernel.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-kernel.xml,v
retrieving revision 1.6
retrieving revision 1.7
diff -u -r1.6 -r1.7
--- hb-install-x86-kernel.xml	24 Nov 2005 17:26:11 -0000	1.6
+++ hb-install-x86-kernel.xml	8 Jan 2006 14:05:30 -0000	1.7
@@ -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/2005.1/hb-install-x86-kernel.xml,v 1.6 2005/11/24 17:26:11 neysx Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/handbook/2005.1/hb-install-x86-kernel.xml,v 1.7 2006/01/08 14:05:30 neysx Exp $ -->
 
 <sections>
 
-<version>5.4</version>
-<date>2005-11-24</date>
+<version>5.5</version>
+<date>2006-01-06</date>
 
 <section>
 <title>Timezone</title>
@@ -61,19 +61,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">
@@ -82,18 +85,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 
@@ -179,14 +170,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;
     &lt;*&gt; /proc file system support
-    &lt; &gt; /dev file system support (OBSOLETE)
     &lt;*&gt; Virtual memory file system support (former shm fs)
 
 
@@ -295,23 +285,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