4.3BSD-UWisc/man/cat7/man.7

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/man0/xx.

     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/lib/tmac/tmac.an
     /usr/man/man0/xx

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
                            Roman.



Printed 12/27/86          May 15, 1986                          1






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



.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 12/27/86          May 15, 1986                          2