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 _t_e_x_t 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 _t_r_o_f_f.

     \*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