SysIII/usr/src/man/man1/man.1

Compare this file to the similar file:
Show the results in this format: 

.tr ~"
.if t .ds i \(fm\(fm
.if n .ds i ""
.TH MAN 1
.SH NAME
man \- print entries in this manual
.SH SYNOPSIS
.B man
[ options ] [ section ] titles
.SH DESCRIPTION
.I Man\^
locates and prints the entry of this manual named
.I title\^
in the specified
.IR section .
(For historical reasons, the word ``page''
is often used as a synonym for ``entry'' in this context.)\ 
The
.I title\^
is entered in lower case.
The
.I section\^
number may not have
a letter suffix.
If no
.I section\^
is specified, the whole manual is searched for
.I title\^
and all occurrences of it are printed.
.I Options\^
and their meanings are:
.PP
.PD 0
.TP 11
.B \-t
Typeset the entry
in the default format (8.5\*i\(mu11\*i).
.TP
.B \-s
Typeset the entry in the small format (6\*i\(mu9\*i).
.TP
.B \-T4014
Display the typeset output on a Tektronix 4014 terminal using
.IR tc (1).
.TP
.B \-Ttek
Same as
.BR \-T4014 .
.TP
.B \-Tst
Print the typeset output on the
.SM MHCC STARE
facility
(see
.IR gcat (1C)).
.TP
.B \-Tvp
Print the typeset output on a
Versatec printer using
.IR vpr (1);
this option is not available at all
.SM UNIX
sites.
.TP
.BI \-T term\^
Format the entry using
.IR nroff (1)
and print it on the standard output
(usually, the terminal);
.I term\^
is the terminal type (see
.IR term (7)
and the explanation below);
for a list of recognized values of
.IR term ,
type
.BR "help term2" .
The default value of
.I term\^
is
.BR 450 .
.TP
.B \-w
Print on the standard output only the
.I "path names\^"
of the entries,
relative to
.BR /usr/man ,
or to the current directory for
.B \-d
option.
.TP
.B \-d
Search the current directory rather than
.BR /usr/man ;
requires the full file name (e.g.,
.BR cu.1c ,
rather than just
.BR cu ).
.TP
.B \-12
Indicates that the manual entry is to be produced in
12-pitch.
May be used when
.SM
.B $TERM
(see below)
is set to one of
.BR 300 ,
.BR 300s ,
.BR 450 ,
and
.BR 1620 .
(The pitch switch on the
.SM DASI
300 and 300s terminals must be manually set to
.B 12
if this option is used.)
.TP
.B \-c
Causes
.I man\^
to invoke
.IR col (1);
note that
.IR col (1)
is invoked automatically by
.I man\^
unless
.I term\^
is one of
.BR 300 ,
.BR 300s ,
.BR 450 ,
.BR 37 ,
.BR 4000A ,
.BR 382 ,
.BR 4014 ,
.BR tek ,
.BR 1620 ,
and
.BR X .
.TP
.B \-y
Causes
.I man\^
to use the non-compacted version of the macros.
.PD
.PP
The above
.I options\^
are mutually exclusive, except that the
.B \-s
option may be used in conjunction with the first four
.B \-T
options above.
Any other
.I options\^
are passed to
.IR troff (1),
.IR nroff (1),
or the
.IR man (7)
macro package.
.PP
When using
.IR nroff (1),
.I man\^
examines the environment variable
.SM
.B $TERM
(see
.IR environ (7))
and attempts to select options to
.IR nroff (1),
as well as filters,
that adapt the output to the terminal being used.
The
.BI \-T term\^
option overrides the value of
.SM
.BR $TERM\*S ;
in particular, one should use
.B \-Tlp
when sending the output of
.I man\^
to a line printer.
.PP
.I Section\^
may be changed before each
.IR title .
.PP
As an example:
.IP
man \|man
.PP
would reproduce on the terminal this entry,
as well as any other entries named
.I man\^
that may exist in other sections of the manual, e.g.,
.IR man (7).
.PP
If the first line of the input for an entry consists
solely of the string:
.IP
.BI \&\(fm\^\e~\| " x"
.PP
where
.I x\^
is any combination of the three characters
.BR c ,
.BR e ,
and
.BR t ,
and
where there is exactly one blank between the double quote
.RB ( ~ )
and
.IR x ,
then
.I man\^
will preprocess its input through the appropriate combination of
.IR cw (1),
.IR eqn (1)
or
.IR neqn (1),
and
.IR tbl (1),
respectively.
.SH FILES
/usr/man/man[1-8]/\(**
.br
/usr/man/local/man[1-8]/\(**
.SH SEE ALSO
cw(1),
eqn(1),
gcat(1C),
tbl(1),
tc(1),
troff(1),
environ(7),
man(7),
term(7).
.SH BUGS
All entries are supposed to be reproducible either on
a typesetter or on a terminal.
However, on a terminal some information is necessarily lost.
.tr ~~