NAME

ms − macros for formatting manuscripts

SYNOPSIS

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

DESCRIPTION

This package of ­nroff and troff(1) macro definitions provides a canned formatting facility for tech%nical papers in various formats.

The macro requests are defined below.  Many ­nroff and ­troff requests are unsafe in conjunction with this package, but the following requests may be used with impunity after the first .PP: .bp, .br, .sp, .ls, .na. 

Output of the eqn(1), tbl(1), pic(1) and grap(1) preprocessors for equations, tables, pictures, and graphs is acceptable as input.

FILES

­/sys/lib/tmac/tmac.s

SEE ALSO

M. E. Lesk, “Typing Documents on the UNIX System: Using the −ms Macros with Troff and Nroff”, Unix Research System Programmer’s Manual, Tenth Edition, Volume 2. 
eqn(1), troff(1), tbl(1), pic(1)

REQUESTS

RequestInitialCauseExplanation

ValueBreak

.1CyesyesOne column format on a new page. 

.2CnoyesTwo column format. 

.ABnoyesBegin abstract. 

.AE-yesEnd abstract. 

.AInoyesAuthor’s institution follows.  Suppressed in .TM. 

.ATnoyesPrint ‘Attached’ and turn off line filling. 

.AU x ynoyesAuthor’s name follows.  x is location and y is extension, ignored except in TM. 

.B x ynonoPrint ­x in boldface, append y; if no argument switch to boldface.

.B1noyesBegin text to be enclosed in a box. 

.B2noyesEnd boxed text. 

.BI x ynonoPrint ­x in bold italic and append y; if no argument switch to bold italic.

.BTdatenoBottom title, automatically invoked at foot of page.  May be redefined. 

.BX xnonoPrint ­x in a box. 

.CW x ynonoConstant width font for x, append y; if no argument switch to constant width.

.CTnoyesPrint ‘Copies to’ and turn off line filling. 

.DA xnroffno‘Date line’ at bottom of page is x. Default is today.

.DE-yesEnd displayed text.  Implies .KE. 

.DS xnoyesStart of displayed text, to appear verbatim line-by-line: ­I indented (default), ­L left-justified, ­C centered, ­B (block) centered with straight left margin.  Implies .KS. 

.EGno-Print document in BTL format for ‘Engineer’s Notes.’  Must be first. 

.EN-yesSpace after equation produced by ­neqn or eqn(1).

.EQ x y-yesDisplay equation.  Equation number is y. Optional ­x is I, L, C as in .DS. 

.FE-yesEnd footnote. 

.FP x-noSet font positions for a family, e.g., ­.FP lucidasans

.FSnonoStart footnote.  The note will be moved to the bottom of the page. 

.HO-no‘Bell Laboratories, Holmdel, New Jersey 07733’. 

.I x ynonoItalicize x, append y; if no argument switch to italic.

.IHnono‘Bell Laboratories, Naperville, Illinois 60540’

.IMnonoPrint document in BTL format for an internal memorandum.  Must be first. 

.IP x ynoyesStart indented paragraph, with hanging tag x. Indentation is ­y ens (default 5). 

.KE-yesEnd keep.  Put kept text on next page if not enough room. 

.KFnoyesStart floating keep.  If the kept text must be moved to the next page, float later text back to this page. 

.KSnoyesStart keeping following text. 

.LGnonoMake letters larger. 

.LPyesyesStart left-blocked paragraph. 

.LTnoyesStart a letter; a non-empty first argument produces a full Lucent letterhead, a second argument is a room number, a third argument is a telephone number. 

.MF--Print document in BTL format for ‘Memorandum for File.’  Must be first. 

.MH-no‘Bell Laboratories, Murray Hill, New Jersey 07974’. 

.MR--Print document in BTL format for ‘Memorandum for Record.’  Must be first. 

.ND datetroffnoUse date supplied (if any) only in special BTL format positions; omit from page footer. 

.NH n-yesSame as .SH, with automatic section numbers  like ‘1.2.3’; ­n is subsection level (default 1). 

.NLyesnoMake letters normal size. 

.P1-yesBegin program display in constant width font. 

.P2-yesEnd program display. 

.PE-yesEnd picture; see pic(1).

.PF-yesEnd picture; restore vertical position. 

.PPnoyesBegin paragraph.  First line indented. 

.PS h w-yesStart picture; height and width in inches. 

.PY-no‘Bell Laboratories, Piscataway, New Jersey 08854’

.QE-yesEnd quoted material. 

.QP-yesBegin quoted paragraph (indent both margins). 

.QS-yesBegin quoted material (indent both margins). 

.RyesnoRoman text follows. 

.RE-yesEnd relative indent level. 

.RPno-Cover sheet and first page for released paper.  Must precede other requests. 

.RS-yesStart level of relative indentation from which subsequent indentation is measured. 

.SG xnoyesInsert signature(s) of author(s), ignored except in ­.TM and .LT.  x is the reference line (initials of author and typist).

.SH-yesSection head follows, font automatically bold. 

.SMnonoMake letters smaller. 

.TA x...5...noSet tabs in ens.  Default is 5 10 15 ... 

.TE-yesEnd table; see tbl(1).

.TH-yesEnd heading section of table. 

.TLnoyesTitle follows. 

.TM x...no-Print document in BTL technical memorandum format.  Arguments are TM number, (quoted list of) case number(s), and file number.  Must precede other requests. 

.TR x--Print in BTL technical report format; report number is x.  Must be first. 

.TS x-yesBegin table; if ­x is ­H table heading is repeated on new pages. 

.UL x-noUnderline argument (even in troff). 

.UX y z-no‘zUNIXy’; first use gives registered trademark notice. 

.WH-no‘Bell Laboratories, Whippany, New Jersey 07981’. 

Plan 9  —  May 13, 2000