avoid throwing away errors when reinitializing (from guy@sun.com)

[unix-history] / usr / src / share / man / man7 / man.7

.\"	@(#)man.7	6.3 (Berkeley) %G%
.\"
.TH MAN 7 ""
.AT 3
.SH NAME
man \- macros to typeset manual
.SH SYNOPSIS
.B
nroff  \-man\ 
file ...
.PP
.B
troff  \-man\ 
file ...
.SH DESCRIPTION
These macros are used to lay out pages of this manual.
A skeleton page may be found in the file 
/usr/man/man0/xx.
.PP
Any text argument
.I t
may be zero to six words.
Quotes may be used to include blanks in a `word'.
If 
.I text
is empty,
special treatment is applied to
the next input line with text to be printed.
In this way
.BR . I
may be used to italicize a whole line, or
.BR . SM
may be
followed by
.BR . B
to make small bold letters.
.PP
A prevailing indent distance is remembered between
successive indented paragraphs,
and is reset to default value upon reaching a non-indented paragraph.
Default units for indents
.I i
are ens.
.PP
Type font and size are reset to default values
before each paragraph, and after processing
font and size setting macros.
.PP
These strings are predefined by
.BR \-man :
.IP \e*R
.if t `\*R', `(Reg)' in
.if t .I nroff.
.if n `(Reg)', trademark symbol in
.if n .I troff.
.IP \e*S
Change to default type size.
.SH FILES
/usr/lib/tmac/tmac.an
.br
/usr/man/man0/xx
.SH SEE ALSO
troff(1), man(1)
.SH BUGS
Relative indents don't nest.
.SH REQUESTS
.ta \w'.TH n c x v m'u +\w'Cause 'u +\w'Argument\ 'u
.di xx
			\ka
.br
.di
.in \nau
.ti0
Request	Cause	If no	Explanation
.ti0
	Break	Argument
.ti0
.tr ~.
~B \fIt\fR	no	\fIt\fR=n.t.l.*	Text
.I t
is bold.
.ti0
~BI \fIt\fR	no	\fIt\fR=n.t.l.	Join
words of
.I t
alternating bold and italic.
.ti0
~BR \fIt\fR	no	\fIt\fR=n.t.l.	Join
words of
.I t
alternating bold and Roman.
.ti0
~DT	no	.5i 1i...	Restore default tabs.
.ti0
~HP \fIi\fR	yes	\fIi\fR=p.i.*	Set prevailing indent to
.I i.
Begin paragraph with hanging indent.
.ti0
~I \fIt\fR	no	\fIt\fR=n.t.l.	Text
.I t
is italic.
.ti0
~IB \fIt\fR	no	\fIt\fR=n.t.l.	Join
words of
.I t
alternating italic and bold.
.ti0
~IP \fIx i\fR	yes	\fIx\fR=""	Same as .TP with tag
.I x.
.ti0
~IR \fIt\fR	no	\fIt\fR=n.t.l.	Join
words of
.I t
alternating italic and Roman.
.ti0
~LP	yes	-	Same as .PP.
.ti0
~PD \fId\fR	no	\fId\fR=.4v	Interparagraph distance is 
.I d.
.ti0
~PP	yes	-	Begin paragraph.
Set prevailing indent to .5i.
.ti0
~RE	yes	-	End of relative indent.
Set prevailing indent to amount of starting .RS.
.ti0
~RB \fIt\fR	no	\fIt\fR=n.t.l.	Join
words of
.I t
alternating Roman and bold.
.ti0
~RI \fIt\fR	no	\fIt\fR=n.t.l.	Join
words of
.I t
alternating Roman and italic.
.ti0
~RS \fIi\fR	yes	\fIi\fR=p.i.	Start relative indent,
move left margin in distance
.I i.
Set prevailing indent to .5i for nested indents.
.ti0
~SH \fIt\fR	yes	\fIt\fR=n.t.l.	Subhead.
.ti0
~SM \fIt\fR	no	\fIt\fR=n.t.l.	Text
.I t
is small.
.ti0
~TH \fIn c x v m\fR	yes	-	Begin page named
.I n
of chapter
.IR c;
.I x
is extra commentary, e.g. `local', for page foot center;
.I v
alters page foot left, e.g. `4th Berkeley Distribution';
.I m
alters page head center, e.g. `Brand X Programmer's Manual'.
Set prevailing indent and tabs to .5i.
.ti0
~TP \fIi\fR	yes	\fIi\fR=p.i.	Set prevailing indent to
.I i.
Begin indented paragraph
with hanging tag given by next text line.
If tag doesn't fit, place it on separate line.
.PP
.ti0
* n.t.l. = next text line; p.i. = prevailing indent