(man): Mention Man-switches in the doc string.

(Man-switches): Mention -a in the doc string.

2 files changed, 10 insertions, 2 deletions

diff --git a/lisp/ChangeLog b/lisp/ChangeLog
index ac29c56037d..ee5b2274275 100644
--- a/lisp/ChangeLog
+++ b/lisp/ChangeLog
@@ -1,5 +1,8 @@
 2001-08-01  Eli Zaretskii  <eliz@is.elta.co.il>
 
+        * man.el (man): Mention Man-switches in the doc string.
+        (Man-switches): Mention -a in the doc string.
+
         * textmodes/ispell.el (ispell-alternate-dictionary): Add
         /usr/share/lib/dict/words, for Irix.
 
diff --git a/lisp/man.el b/lisp/man.el
index c7a2d43153c..5e3fc280d29 100644
--- a/lisp/man.el
+++ b/lisp/man.el
@@ -285,7 +285,10 @@ This regular expression should start with a `^' character.")
   "Regular expression describing a reference in the SEE ALSO section.")
 
 (defvar Man-switches ""
-  "Switches passed to the man command, as a single string.")
+  "Switches passed to the man command, as a single string.
+
+If you want to be able to see all the manpages for a subject you type,
+make -a one of the switches, if your `man' program supports it.")
 
 (defvar Man-specified-section-option
   (if (string-match "-solaris[0-9.]*$" system-configuration)
@@ -549,7 +552,9 @@ results in a Man mode (manpage browsing) buffer.  See variable
 If a buffer already exists for this man page, it will display immediately.
 
 To specify a man page from a certain section, type SUBJECT(SECTION) or
-SECTION SUBJECT when prompted for a manual entry."
+SECTION SUBJECT when prompted for a manual entry.  To see manpages from
+all sections related to a subject, put something appropriate into the
+`Man-switches' variable, which see."
   (interactive
    (list (let* ((default-entry (Man-default-man-entry))
                 (input (read-string