Mercurial > emacs

changeset 29840:53f07097269e

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
(Documentation Commands): Explain how to get a man page from a particular section, with `man' and `woman'.
author Eli Zaretskii <eliz@gnu.org>
date Wed, 21 Jun 2000 16:45:55 +0000
parents f83ad43b544a
children 2b8edcad6b0f
files man/programs.texi
diffstat 1 files changed, 15 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/man/programs.texi	Wed Jun 21 16:43:44 2000 +0000
+++ b/man/programs.texi	Wed Jun 21 16:45:55 2000 +0000
@@ -1582,6 +1582,16 @@
 Man mode, that facilitates scrolling and examining other manual pages.
 For details, type @kbd{C-h m} while in a man page buffer.
 
+@cindex sections of manual pages
+  Man pages are subdivided into @dfn{sections}, and some man pages have
+identical names, but belong to different sections.  To read a man page
+from a certain section, type @kbd{@var{topic}(@var{section})} or
+@kbd{@var{section} @var{topic}} when @kbd{M-x manual-entry} prompts for
+the topic.  For example, to read the man page for the C library function
+@code{chmod} (as opposed to a command by the same name), type @kbd{M-x
+manual-entry @key{RET} chmod(2v) @key{RET}} (assuming @code{chmod} is in
+section @code{2v}).
+
 @vindex Man-fontify-manpage-flag
   For a long man page, setting the faces properly can take substantial
 time.  By default, Emacs uses faces in man pages if Emacs can display
@@ -1613,6 +1623,11 @@
 manual pages used for completion.  This is useful if you add or delete
 manual pages.
 
+  If you type a name of a manual page and @kbd{M-x woman} finds that
+several manual pages by the same name exist in different sections, it
+pops up a window with possible candidates asking you to choose one of
+them.
+
 @vindex woman-manpath
   By default, @kbd{M-x woman} looks up the manual pages in directories
 listed by the @code{MANPATH} environment variable.  (If @code{MANPATH}