MAN(C) XENIX System V MAN(C)
Name
man - Prints reference pages in this guide.
Syntax
man [-afbcw] [-tproc] [-ppager] [-ddir] [-
Tterm] [section] [title]
Description
The man program locates and prints the named title from the
designated section in the XENIX Reference. For historical
reasons, ``page'' is often used as a synonym for ``entry''
in this context.
Since commands are given in lowercase, the title is always
entered in lowercase. If no section is specified, the whole
guide is searched for title and the first occurrence of it
is printed. You can search for a group of sections by
separating the section names with colons (:) on the command
line.
The options and their meanings are:
-a ``All'' mode. Displays all matching titles.
Incompatible with f mode.
-f ``First'' mode. Displays only the first matching
title. Incompatible with a mode. This is the
default mode for man.
-b Leaves blank lines in output. nroff(CT) pads
entries with blank lines for line printer
purposes. man normally filters out these excess
blank lines. Normally, man does not display more
than 2 consecutive blank lines. The -b flag
leaves blank lines in the CRT output.
-c Causes man to invoke col(CT). Note that col is
invoked automatically by man unless term is one
of the following: 300, 300s, 450, 37, 4000a,
382, 4014, tek, 1620, and X.
-w Prints on the standard output only the pathnames
of the entries.
-tproc Indicates that if an unprocessed manual page is
available, it is to be passed to proc for
formatting. proc can be any command script in
/usr/man/bin or an absolute filename of a text
processing program elsewhere on the system, for
example /bin/nroff.
Page 1 (printed 2/7/91)
MAN(C) XENIX System V MAN(C)
The scripts in /usr/man/bin invoke the actual
processing programs with the correct flags and
arguments. The default processor is
/usr/man/bin/nr, which invokes /bin/nroff and
produces output that safely prints on any
terminal. The text is also preprocessed by
eqn(CT) and tbl(CT) as a default.
-ppager Selects paging program pager to display the
entry. Paging systems such as more(C), pg(C),
cat(C), or any custom pagers that you may have
are valid arguments for this flag. The default
pager, pg(C), is set in /etc/default/man.
-ddir Specifies directory dir to be added to the search
path for entries. You can specify several
directories to be searched for entries by
separating the directory names with colons (:) on
the command line.
-Tterm Format the entry and pass the given term value to
the processing program, then print it on the
standard output (usually, the terminal); term is
the terminal type (see term(M) and the
explanation below); for a list of the recognized
values of term, type help term2. The default
value of term is 450.
Section Names
The names and general descriptions of the available manual
sections are:
C Commands
M Miscellaneous
F File Formats
HW Hardware Dependent
CT Text Processing Commands
S Subroutines and Libraries
CP Programming Commands
DOS DOS Subroutines and Libraries
UCB University of California, Berkeley, Utilities
LOCAL Local utilities for your system
You can add other section names as you desire. Each new
section, however, must follow the standard section directory
structure. The UCB and LOCAL directories are shipped to you
without contents, as no LOCAL or UCB manual pages are
included with .
/usr/man Directory Structure
The source files for the man program are kept in the
directory /usr/man. Each man section is comprised of two
directories, and there is a directory called bin for
Page 2 (printed 2/7/91)
MAN(C) XENIX System V MAN(C)
programs and shell scripts related to man. There is also an
index file called index in /usr/man. This index is a list of
all commands and their sections.
Each manual section has two directories in /usr/man. These
directories are called man and cat, plus the name of the
section as a suffix. For example, the C manual section is
comprised of two directories, man.C and cat.C, both located
in /usr/man.
The unprocessed source text is in the man directory and the
printable processed output is in the cat directory. When a
title is requested, both directories are checked. The most
recent copy of the manual page is used as the current copy.
If the most recent title is in the source text directory and
it is processed by the default processor with the default
terminal type, a display copy of the output is placed in the
cat directory for future use. Note that a file that must be
processed takes longer to appear on the screen than a
display copy.
Environment Variables
There is a shell environment variable for use with the man
utility. This variable is called MANPATH and it is used to
change or augment the path man searches for entries.
Multiple directories set with this variable must be
delimited by colon characters (:). If the MANPATH
environment variable is present, the directories are
searched in the order that they appear. /usr/man must
appear in the MANPATH list to be included. If you set this
environment variable, it supercedes the MANPATH entry in the
/etc/default/man file. Alternate subdirectories are
expected to have the same form as the default directories in
/usr/man.
Page 3 (printed 2/7/91)
MAN(C) XENIX System V MAN(C)
/etc/default/man
There is a file called man in the /etc/default directory
that contains the default settings for the man utility. The
following options are set in /etc/default/man:
PAGER=pg
MANPATH=/usr/man
TERM=lp
ORDER=C:S:CP:CT:M:F:HW:DOS:UCB:LOCAL
MODE=FIRST
PROC=nr
You can select a different paging system, search path,
terminal type, search order, mode, and processor for the man
system by changing the information in this file.
To change the search order for manual sections, edit the
list following the ORDER variable. Be certain the section
names are separated with colons (:). Section names not
present in ORDER are searched in arbitrary order after those
specified in /etc/default/man.
Creating New Manual Entries
You can create new manual pages for utilities and scripts
that you have developed. Use an existing manual page as an
example of manual page structure. Use the man macros to
format your manual page. For more information, refer to the
nroff(CT) manual page.
You must be logged in as root (the ``Super-User'') to place
a new manual page in your /usr/man directory structure.
Place your new page in /usr/man/man.LOCAL while logged in as
root and view it using the man command, since only root has
write permission for the catable directories. Once man has
produced the catable output, any user can view the new page
in the same manner as any other on line manual page.
Additionally, you can create your own custom sections by
creating another manual directory and putting it in the
MANPATH. For example, if subdirectories man.X and cat.X are
present, then man recognizes that X is a valid manual
section.
If you wish to use another text processing program (such as
troff(CT)) to process your custom manual pages, use the
Page 4 (printed 2/7/91)
MAN(C) XENIX System V MAN(C)
-tproc flag of man. proc can be any shell script in
/usr/man/bin. To place a catable copy of the manual page in
the cat directory, use the tee(C) command to send the output
to a file, as well as to the standard output. Your command
should have the form:
man -tproc filename | tee pathname
In the above example, proc is the text processing script,
filename is the manual page source file, and pathname is the
path of the directory for the catable output.
Custom manual sections can have an index, if the format is
the same as the index in /usr/man. man uses the index to
locate multiple commands that are listed on the same page as
well as commands that have pages in several different
sections.
The man Macro Package
The man macro package is located in /usr/lib/macros/an.
There are 15 basic macros in the package. Here is a table of
the macros and brief descriptions of their functions:
Macro Description
________________________________________
.TH title Title Heading
.SH title Section Heading
.SS title Subsection Heading
.SM text Reduce Point Size
.PP New Paragraph
.IP Indented Paragraph
.HP Hanging Paragraph
.TP Tagged Paragraph
.DA date Date of Document
.RS n Relative Indent
.RE Release Relative Indent
.I text Italic Font
.B text Bold Font
.R text Roman Font
.PM Proprietary Mark (copyright)
See Also
eqnchar(CT), nroff(CT), tbl(CT), troff(CT), environ(M),
term(CT).
Notes
All entries are supposed to be reproducible either on a
typesetter or on a terminal. However, on a terminal some
information, such as eqn(CT) and tbl(CT) output, is either
Page 5 (printed 2/7/91)
MAN(C) XENIX System V MAN(C)
lost or approximated as it cannot be exactly reproduced.
The man macros, nroff(CT), troff(CT), and other (CT)
commands are components of the Text Processing System.
Page 6 (printed 2/7/91)