From 3c788d225354fad9910deca6003a05ec037be814 Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Wed, 21 Jun 2000 16:45:55 +0000 Subject: [PATCH] (Documentation Commands): Explain how to get a man page from a particular section, with `man' and `woman'. --- man/programs.texi | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/man/programs.texi b/man/programs.texi index 6b2b89e3f94..200de32417d 100644 --- a/man/programs.texi +++ b/man/programs.texi @@ -1582,6 +1582,16 @@ named @samp{*Man @var{topic}*}. These buffers use a special major mode, 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 @@ page. 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} -- 2.39.2