(describe-mode): Doc fix.

2 files changed, 9 insertions, 5 deletions

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index bc487ea1726..ff91d256127 100644
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -9,6 +9,8 @@
         (ibuffer): Save window configuration before showing Ibuffer
         buffer.
 
+        * help.el (describe-mode): Doc fix.
+
 2004-04-12  Stefan Monnier  <monnier@iro.umontreal.ca>
 
         * progmodes/compile.el (compilation-mode-font-lock-keywords): Fix test
diff --git a/lisp/help.el b/lisp/help.el
index 82a43c6868b..b589de94474 100644
--- a/lisp/help.el
+++ b/lisp/help.el
@@ -564,11 +564,13 @@ the last key hit are used."
 
 (defun describe-mode (&optional buffer)
   "Display documentation of current major mode and minor modes.
-The major mode description comes first, followed by the minor modes,
-each on a separate page.
-For this to work correctly for a minor mode, the mode's indicator variable
-\(listed in `minor-mode-alist') must also be a function whose documentation
-describes the minor mode."
+A brief summary of the minor modes comes first, followed by the
+major mode description.  This is followed by detailed
+descriptions of the minor modes, each on a separate page.
+
+For this to work correctly for a minor mode, the mode's indicator
+variable \(listed in `minor-mode-alist') must also be a function
+whose documentation describes the minor mode."
   (interactive)
   (help-setup-xref (list #'describe-mode (or buffer (current-buffer)))
                    (interactive-p))