PWB1/usr/man/man1/man.1

.th MAN I 5/31/77
.sh NAME
man \*- print on-line documentation
.sh SYNOPSIS
.bd man
[options] documents ...
.sh DESCRIPTION
.it Man
is a shell command file that prints on-line documentation on the standard output
by use of 
.it nroff\c
(I) or
.it troff\c
(I).
On-line documentation consists of 
manual pages
from the PWB/UNIX User's Manual. 
.s3
The command line to print
.it "manual pages"
consists of
.s3
.ti 10
man [term] [\*-s]  [section] title
.s3
where "term" is one of the following:
.s3
.lp 14 7
.bn \*-t
produces photocomposed
output;
.s3
.lp 14 7
.bn \*-g
adapts the output to a DASI 300 terminal in
12-pitch mode;
.s3
.lp 14 7
.bn \*-450
adapts the output to the DASI 450 terminal in 10 or 12-pitch mode;
.s3
.lp 14 7
.bn \*-hp
adapts the output to a Hewlett Packard
terminal;
.s3
.lp 14 7
.bn \*-v
followed by a space and a bin number, produces
output on the Versatec printer.
Exactly one bin number
.it must
be specified when the 
.bd \*-v
option is used.
.i0
.s3
The 
.bd \*-s
option prints only the SYNOPSIS portion of a manual page.
.s3
.it Section
is the section number in the PWB/UNIX User's Manual
in which a manual page is filed.
It is specified as a single Arabic decimal digit.
If
.it section
is omitted on the command line,
the section number defaults to 1.
If it is not in the given section, then a search is made
in
.it all
sections of the manual.
If the page is not found (i.e., does not
exist), an error message is produced.
.s3
.it Title
is the name of the manual page.
One or more titles may be specified in a single command.
.s3
Thus, the command line
.s3
.ti 10
man \*-g 1 ed man tbl
.s3
would print out (in 12-pitch on a DASI 300 terminal)
the currently installed versions of the commands
.it "ed, man,"
and
.it tbl,
all of 
which can currently
be found in Section I of the manual.
.sh DIAGNOSTICS
.lp 35 30
"man page for xxx not found"	\c
A manual page for xxx does not exist.
.i0
.sh FILES
.lp 35 30
/usr/man/man[0-8]	\c
Installed PWB/UNIX documentation. 
.i0
.sh "SEE ALSO"
For those who wish to
.it write
manual pages such as those accessed by this
command, see
.it "PWB/UNIX Manual Page Macros"
by E. M. Piskorik.