|
|
HP-UX Reference > Mman(1)HP-UX 11i Version 2: December 2007 Update |
|
NAMEman — find manual information by keywords; print out a manual entry SYNOPSISman [-M path] -k keyword... man [-M path] -f file... man [-] [-M path] [-T macro-package] [section[subsection]] entry_name... DESCRIPTIONman accesses information from the HP-UX manual pages. It can be used to:
Searching for Entry Names by Keyword (first form)The first form above searches the one-line descriptions of individual entries for specified keywords. Arguments are as follows:
Obtaining One-Line Description of an Entry (second form)The second form above finds and displays or prints the one-line descriptions of specified individual entries. Arguments are as follows:
Viewing Individual Manual Entries (third form)The third form shown above is used for viewing one or more individual manual entries. man in this form recognizes the following arguments:
If the standard output is a teletype, and if the - flag is not given, man pipes its output through more (see more(1)), with the -s option, to eliminate multiple blank lines and stop after each screenful. This default behavior can be changed by setting the PAGER variable in the user's environment. The value of PAGER must be a string that names an output filter (such as pg(1)), along with the desired options. File Search Conventionsman searches in several directories, as appropriate, for the specified manual entry. The search continues until either the entry is found or all candidate directories are searched. The first three directories searched, in order, are: /usr/share/man, /usr/contrib/man, and /usr/local/man. The MANPATH environment variable can be used to specify directories to be searched, and, if set, overrides the default paths given above. Upon logging in, /etc/profile ( or /etc/csh.login ) sets the MANPATH environment variable to default settings. If the file /etc/MANPATH exists, the default settings are taken from this file. The MANPATH variable follows the same form as the PATH variable (see environ(5)). Within each of these directories, man searches in the cat*.Z subdirectories, the man*.Z subdirectories, the cat* subdirectories, and the man* subdirectories. man*.Z and man* directories contain nroff(1)-compatible source text for the entries. cat*.Z and cat* directories contain the formatted versions of the entries. man*.Z and cat.Z directories contain entries in compressed form. Files in these directories are uncompressed by uncompress (see compress(1)) before being processed for printing or display. If the LANG environment variable is set to any valid language name defined by lang(5), and the MANPATH variable is not set, or is set to the default directories, man searches in three additional directories for the manual entry before searching in /usr/share/man. First, man searches in /usr/share/man/$LANG, then in /usr/contrib/man/$LANG, then in /usr/local/man/$LANG. Thus, native-language manual entries are displayed if they are present and installed properly in the system. If the MANPATH environment variable is set to anything other than the default, the above directories with $LANG as part of the path are not automatically searched. All directories must be explicitly given in MANPATH. The %L, %l, %t, and %c specifiers can be used as path components to cause locale-specific directories to be searched. See environ(5) for a complete description of MANPATH. man uses the most recent version that it finds in the subdirectories searched. If the most recent version is in:
If only the cat* or cat*.Z subdirectory is present and/or nroff(1) is not installed, only entries that are already formatted can be displayed. If you choose to have the formatted entries on your system, run catman(1M) with the default, which creates the cat*.Z directories (after removing any cat* directories that exist on your system) and also creates the file /usr/share/lib/whatis used by the man -k option. If you choose to have the cat* directories, it would be space-saving to remove any cat*.Z directories that may exist on your system. Beware that man updates both directories (cat* and cat*.Z) if they both exist. Special Manual EntriesSome situations may require creation of manual entries for local use or distribution by third-party software suppliers. The manual formatting macros have been structured to redefine page footers so that manual entries not originating from Hewlett-Packard Company do not show the HP name in the footer. For more information about this change and a description of the manual formatting macros used with nroff or troff, see man(5). EXTERNAL INFLUENCESEnvironment VariablesLANG determines the language in which messages are displayed. LANG is also used to determine the search path (as described above). If LANG is not specified or is set to the empty string, a default of "C" (see lang(5)) is used instead of LANG for messages, but not for the search path. If any internationalization variable contains an invalid setting, man behaves as if all internationalization variables are set to "C". See environ(5). MANPATH, if set, gives a list of directories to be searched for the given entry, replacing the default paths. PAGER, if set, defines an output filter to be used instead of more(1) to paginate output. EXAMPLESList the manual entries that contain the word grep in their respective one-line description (NAME) lines: man -k grep The output is: grep, egrep, fgrep (1) - search a file for a pattern zgrep(1) - search possibly compressed files for a regular expression Print the one-line description of the grep(1) manual entry: man -f grep Print the entire grep(1) manual entry: man grep Set a search path that includes a path directly below the current directory. The manual entry, mypage is assumed to exist in the directory ./man1 (or ./man1.Z, cat1, or cat1.Z). MANPATH=.:/usr/share/man:/usr/contrib/man:/usr/local/man export MANPATH man mypage Display the manual entry for id(1), with the output piped through pg -c: PAGER="pg -c" export PAGER man id List all printed manuals available for the current system (see manuals(5): man manuals Display intro(4) and intro(3):
WARNINGSManual entries are structured such that they can be printed on a phototypesetter, conventional line printer, and screen display devices. However, due to line printer and display device limitations, some information may be lost in certain situations. FILES
SEE ALSOcol(1), compress(1), grep(1), more(1), catman(1M), fixman(1M), environ(5), intro(1), intro(1M), intro(2), intro(3), intro(4), intro(5), intro(7), intro(9), introduction(9), man(5), manuals(5). |
|