2.11BSD#431 - /usr/man/cat7/man.0

MAN(7)		    UNIX Programmer's Manual		   MAN(7)


NAME
     man - macros to typeset manual

SYNOPSIS
     nroff  -man  file ...

     troff  -man  file ...

DESCRIPTION
     These macros are used to lay out pages of this manual.  A
     skeleton page may be found in the file
     /usr/man/man.template.

     Any text argument t may be zero to six words.  Quotes may be
     used to include blanks in a `word'.  If text is empty, spe-
     cial treatment is applied to the next input line with text
     to be printed.  In this way .I may be used to italicize a
     whole line, or .SM may be followed by .B to make small bold
     letters.

     A prevailing indent distance is remembered between succes-
     sive indented paragraphs, and is reset to default value upon
     reaching a non-indented paragraph.  Default units for
     indents i are ens.

     Type font and size are reset to default values before each
     paragraph, and after processing font and size setting mac-
     ros.

     These strings are predefined by -man:

     \*R  `(Reg)', trademark symbol in troff.

     \*S  Change to default type size.

FILES
     /usr/share/tmac/tmac.an
     /usr/man/man.template

SEE ALSO
     troff(1), man(1)

BUGS
     Relative indents don't nest.

REQUESTS
Request      Cause If no    Explanation
	     Break Argument
.B t	     no    t=n.t.l.*Text t is bold.
.BI t	     no    t=n.t.l. Join words of t alternating bold and
			    italic.
.BR t	     no    t=n.t.l. Join words of t alternating bold and


Printed 11/26/99	October 22, 1996			1


MAN(7)		    UNIX Programmer's Manual		   MAN(7)


			    Roman.
.DT	     no    .5i 1i...Restore default tabs.
.HP i	     yes   i=p.i.*  Set prevailing indent to i. Begin
			    paragraph with hanging indent.
.I t	     no    t=n.t.l. Text t is italic.
.IB t	     no    t=n.t.l. Join words of t alternating italic
			    and bold.
.IP x i      yes   x=""     Same as .TP with tag x.
.IR t	     no    t=n.t.l. Join words of t alternating italic
			    and Roman.
.LP	     yes   -	    Same as .PP.
.PD d	     no    d=.4v    Interparagraph distance is d.
.PP	     yes   -	    Begin paragraph.  Set prevailing
			    indent to .5i.
.RE	     yes   -	    End of relative indent.  Set prevail-
			    ing indent to amount of starting .RS.
.RB t	     no    t=n.t.l. Join words of t alternating Roman and
			    bold.
.RI t	     no    t=n.t.l. Join words of t alternating Roman and
			    italic.
.RS i	     yes   i=p.i.   Start relative indent, move left mar-
			    gin in distance i. Set prevailing
			    indent to .5i for nested indents.
.SH t	     yes   t=n.t.l. Subhead.
.SM t	     no    t=n.t.l. Text t is small.
.TH n c x v m	   yes	    -Begin page named n of chapter c; x
			    is extra commentary, e.g. `local',
			    for page foot center; v alters page
			    foot left, e.g. `4th Berkeley Distri-
			    bution'; m alters page head center,
			    e.g. `Brand X Programmer's Manual'.
			    Set prevailing indent and tabs to
			    .5i.
.TP i	     yes   i=p.i.   Set prevailing indent to i. Begin
			    indented paragraph with hanging tag
			    given by next text line.  If tag
			    doesn't fit, place it on separate
			    line.

* n.t.l. = next text line; p.i. = prevailing indent


Printed 11/26/99	October 22, 1996			2