Introduction
@@ -258,20 +258,30 @@
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
-Configuring the Kernel in the Gentoo Handbook.
-To ensure these packages will build against the source tree at
-/usr/src/linux, 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 Configuring the Kernel in the Gentoo Handbook. To ensure these
+packages will build against the source tree at /usr/src/linux,
+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.
We provide you with an easy tool (sys-kernel/module-rebuild) which
-rebuilds all the kernel modules you have installed using separate ebuilds.
+rebuilds all the kernel modules you have installed using separate ebuilds. Its
+use is straightforward. After emerging it, simply run module-rebuild
+populate 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 module-rebuild rebuild to rebuild the
+drivers for your new kernel.
+
+
+
+For more information, run module-rebuild without any options to see a
+list of commands that can be passed to the utility.