m

man(1)

 

 

man(1)

man∗.Z

The entry is uncompressed, formatted, and

displayed. If the cat∗.Z directory

 

exists, the formatted entry is compressed and installed in cat∗.Z.

If the

cat∗

 

directory exists, the formatted entry is installed in cat∗.

 

 

cat∗.Z

The entry is uncompressed and displayed.

 

 

 

man∗

The entry is formatted, and displayed. If

the cat∗.Z directory

exists,

it is

 

compressed, and installed in cat∗.Z. If the

cat∗ directory exists, the formatted

 

entry is installed in cat∗.

 

 

 

cat∗

The entry is displayed.

 

 

 

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 ®le /usr/share/lib/whatis used by the man -koption. If you choose to have the cat∗ directories, it would be space-saving to remove any cat∗.Z directories that may exist on your sys- tem. Beware that man updates both directories (cat* and cat*.Z) if they both exist.

Special Manual Entries

Some 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 rede®ne 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 INFLUENCES

Environment Variables

LANG determines the language in which messages are displayed. LANG is also used to determine the search path (as described above).

If LANG is not speci®ed 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, de®nes an output ®lter to be used instead of more(1) to paginate output.

International Code Set Support

Single- and multi-byte character code sets are supported.

EXAMPLES

List 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

Section 1−522

− 3 −

HP-UX Release 11i: December 2000