/sys/doc/ Documentation archive

MS(VII)                      11/6/74                      MS(VII)

     ms - macros for formatting manuscripts

     nroff -ms [ options ] file ...
     troff -ms [ options ] file ...

     This package of nroff and troff macro definitions provides a
     canned formatting facility for technical papers.  When  pro-
     ducing  2-column  output on a terminal, its output should be
     filtered through col(I).

     The package supports three different formats: BTL  technical
     memorandum  with  cover  sheet,  released  paper  with cover
     sheet, and an abbreviated  `debugging'  form  without  cover

     The  macro requests are defined in the attached Request Ref-
     erence.  Many nroff and troff requests are  unsafe  in  con-
     junction  with this package, however the requests listed be-
     low may be used with impunity after the first .PP.

             .bp  begin new page
             .br  break output line here
             .sp ninsert n spacing lines
             .ls n(line spacing) n=1 single, n=2 double space
             .na  no alignment of right margin

     Output of the eqn, neqn and tbl(I) preprocessors for  equa-
     tions and tables is acceptable as input.


     eqn(I), nroff(I), troff(I), tbl(VI)


                              - 1 -

MS(VII)                      11/6/74                      MS(VII)

                        REQUEST REFERENCE

Request   Initial Cause
Form      Value   Break Explanation

.1C       yes     yes   One column format on a new page.
.2C       no      yes   Two column format.
.AB       no      yes   Begin abstract.
.AE       -       yes   End abstract.
.AI       no      yes   Author's institution follows.  Suppressed
                       in TM.
.AU x y   no      yes   Author's name follows.  x is location and
                       y is extension, ignored except in TM.
.B        no      no    Boldface text follows.
.CS x...  -       yes   Cover sheet info if TM format, suppressed
                       otherwise.  Arguments are number of text
                       pages, other pages, total pages, figures,
                       tables, references.
.DA x     nroff   no    `Date line' at bottom of page is x.  De-
                       fault is today.
.DE       -       yes   End displayed text.  Implies .KE.
.DS x     no      yes   Start of displayed text, to appear verba-
                       tim line-by-line.  x=I for indented dis-
                       play (default), x=L for left-justified on
                       the page, x=C for centered.  Implies .KS.
.EN       -       yes   Space after equation produced by eqn or
.EQ x     -       yes   Space before equation.  Equation number
                       is x.
.FE       -       yes   End footnote.
.FS       no      no    Start footnote.  The note will be moved
                       to the bottom of the page.
.HO       -       no    `Bell Laboratories, Holmdel, New Jersey
.I        no      no    Italic text follows.
.IP x y   no      yes   Start indented paragraph, with hanging
                       tag x.  Indentation is y ens (default 5).
.KE       -       yes   End keep.  Put kept text on next page if
                       not enough room.
.KF       no      yes   Start floating keep.  If the kept text
                       must be moved to the next page, float lat-
                       er text back to this page.
.KS       no      yes   Start keeping following text.
.LG       no      no    Make letters larger.
.LP       yes     yes   Start left-blocked paragraph.
.MH       -       no    `Bell Laboratories, Murray Hill, New Jer-
                       sey 07974'.
.ND       troff   no    No date line at bottom of page.
.NH n     -       yes   Same as .SH, with section number supplied
                       automatically.  Numbers are multilevel,
                       like 1.2.3, where n tells what level is
                       wanted (default is 1).
.NL       yes     no    Make letters normal size.
.OK       -       yes   `Other keywords' for TM cover sheet fol-
.PP       no      yes   Begin paragraph.  First line indented.

                              - 2 -

MS(VII)                      11/6/74                      MS(VII)

.R        yes     no    Roman text follows.
.RE       -       yes   End relative indent level.
.RP       no      -     Cover sheet and first page for released
                       paper.  Must precede other requests.
.RS       -       yes   Start level of relative indentation.
                       Following .IP's measured from current in-
.SG x     no      yes   Insert signature(s) of author(s), ignored
                       except in TM.  x is the reference line
                       (initials of author and typist).
.SH       -       yes   Section head follows, font automatically
.SM       no      no    Make letters smaller.
.TL       no      yes   Title follows.
.TM x y z no      -     BTL TM cover sheet and first page, x=TM
                       number, y=(quoted list of) case number(s),
                       z=file number.  Must precede other re-
.WH       -       no    `Bell Laboratories, Whippany, New Jersey

                              - 3 -