--- kernel-upgrade.xml.orig	2006-01-06 09:10:44.000000000 -0800
+++ kernel-upgrade.xml	2006-01-06 10:03:43.000000000 -0800
@@ -17,8 +17,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>0.1.8</version>
-<date>2005-10-11</date>
+<version>0.1.9</version>
+<date>2006-01-06</date>
 
 <chapter>
 <title>Introduction</title>
@@ -258,20 +258,31 @@
 
 <p>
 If you use any kernel modules that are not included in the kernel source tree
-but are provided elsewhere in portage (e.g. NVIDIA or ATI graphics drivers),
-then you must reinstall these after upgrading the kernel. This is as simple as
-re-merging the packages involved. For more information, refer to the chapter on
-<e>Configuring the Kernel</e> in the <uri 
-link="/doc/en/handbook/index.xml">Gentoo Handbook</uri>.
-To ensure these packages will build against the source tree at
-<path>/usr/src/linux</path>, first uninstall the packages, then re-emerge them.
-If old sources for these packages are kept by portage, this uninstall/re-emerge
-procedure will make sure that they are rebuilt to work with the new kernel.
+but are provided elsewhere in Portage (e.g. ALSA drivers and NVIDIA or ATI
+graphics drivers), then you must reinstall these after upgrading the kernel.
+This is as simple as re-merging the packages involved. For more information,
+refer to the chapter on <e>Configuring the Kernel</e> in the <uri
+link="/doc/en/handbook/index.xml">Gentoo Handbook</uri>.  To ensure these
+packages will build against the source tree at <path>/usr/src/linux</path>,
+first uninstall the packages, then re-emerge them.  If old sources for these
+packages are kept by portage, this uninstall/re-emerge procedure will make sure
+that they are rebuilt to work with the new kernel.
 </p>
 
 <p>
 We provide you with an easy tool (<c>sys-kernel/module-rebuild</c>) which
-rebuilds all the kernel modules you have installed using separate ebuilds.
+rebuilds all the kernel modules you have installed using separate ebuilds (for
+the <b>currently running</b> kernel, not necessarily the one in
+<path>/usr/src/linux</path>). Its use is straightforward. After emerging it,
+simply run <c>module-rebuild populate</c> to populate the database with a list
+of packages that will need to be rebuilt after upgrading the kernel. Once you
+have finished upgrading or recompiling your kernel, run <c>module-rebuild
+rebuild</c> to rebuild the drivers for your new kernel before you reboot.
+</p>
+
+<p>
+For more information, run <c>module-rebuild</c> without any options to see a
+list of commands that can be passed to the utility.
 </p>
 
 </body>