Improve README.modules

* Suggest module-assistant auto-install in README.modules and be clearer
  that building one's own kernel is not required.  Thanks, Anders
  Kaseorg and Lutz Goehring for suggestions.  (LP: #295897)

diff --git a/debian/README.modules b/debian/README.modules
index 63f2c353d80c9224ac9543becbd9b5b54246323a..26431af2ec4281d68de5ccce71bb26668ae025e9 100644 (file)
--- a/debian/README.modules
+++ b/debian/README.modules
@@ -25,16 +25,21 @@ module-assistant
 
   This method is the best one to use when using the kernels that come with
   Debian, since module-assistant knows how to get the right header files
-  to build modules for your currently running kernel.
+  to build modules for your currently running kernel.  Generally, all you
+  should have to do is:
 
-  First, install module-assistant and then prepare the kernel headers and
-  install openafs-modules-source:
+      apt-get install module-assistant
+      module-assistant auto-install openafs
+
+  This combines all of the following steps, taking the defaults.  If you
+  want to do it more step-by-step, first prepare the kernel headers and
+  install openafs-modules-source with:
 
       apt-get install module-assistant
       module-assistant prepare openafs-modules
 
-  (If you want to build modules for a different kernel than your currently
-  running one, pass the -l flag to module-assistant.  See the man page.)
+  If you want to build modules for a different kernel than your currently
+  running one, pass the -l flag to module-assistant.  See the man page.
   module-assistant may be able to find the right packages itself or it may
   tell you to install particular packages.  Once you've finished with
   that, build the module with:
@@ -51,8 +56,8 @@ module-assistant
 
 make-kpkg
 
-  This method works well when you're also building your own kernel, rather
-  than using the pre-packaged Debian one.
+  This method may work better than module-assistant if you're also
+  building your own kernel rather than using the pre-packaged Debian one.
 
   Install a kernel source package and untar it in /usr/src.  Then, install
   openafs-modules-source.

diff --git a/debian/changelog b/debian/changelog
index b02bdc2057f98904c5ac54cbbd7ef3f65b88d658..db84f403c2db7eff7e116e1beb7a68a0c63883b8 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -3,6 +3,9 @@ openafs (1.4.7.dfsg1-7) UNRELEASED; urgency=low
   * Mention libpam-afs-session instead of libpam-openafs-session in the
     description of libpam-openafs-kaserver, and mention libpam-krb5 by
     name.  Thanks, Philipp Kaluza.  (Closes: #501308)
+  * Suggest module-assistant auto-install in README.modules and be clearer
+    that building one's own kernel is not required.  Thanks, Anders
+    Kaseorg and Lutz Goehring for suggestions.  (LP: #295897)
 
  -- Russ Allbery <rra@debian.org>  Mon, 06 Oct 2008 11:10:14 -0700