4BSD/usr/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, the
     special 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 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 11/10/80                                                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 para-
                         graph 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 prevailing
                         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 margin
                         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 yes   -        Begin page named _n of chapter _c; _x is
                         extra commentary, e.g. `local', for page
                         foot.  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/10/80                                                2