1 058b0118 2005-01-03 devnull .TH MS 7
  2 058b0118 2005-01-03 devnull .hc %
  3 058b0118 2005-01-03 devnull .SH NAME
  4 058b0118 2005-01-03 devnull ms \- macros for formatting manuscripts
  5 058b0118 2005-01-03 devnull .SH SYNOPSIS
  6 058b0118 2005-01-03 devnull .B "nroff -ms"
  7 058b0118 2005-01-03 devnull [
  8 058b0118 2005-01-03 devnull .I options
  9 058b0118 2005-01-03 devnull ]
 10 058b0118 2005-01-03 devnull .I file ...
 11 058b0118 2005-01-03 devnull .br
 12 058b0118 2005-01-03 devnull .B "troff -ms"
 13 058b0118 2005-01-03 devnull [
 14 058b0118 2005-01-03 devnull .I options
 15 058b0118 2005-01-03 devnull ]
 16 058b0118 2005-01-03 devnull .I file ...
 17 058b0118 2005-01-03 devnull .SH DESCRIPTION
 18 058b0118 2005-01-03 devnull This package of
 19 058b0118 2005-01-03 devnull .I nroff
 20 058b0118 2005-01-03 devnull and
 21 d32deab1 2020-08-16 rsc .MR troff (1)
 22 058b0118 2005-01-03 devnull macro definitions provides a canned formatting
 23 058b0118 2005-01-03 devnull facility for tech%nical papers in various formats.
 24 058b0118 2005-01-03 devnull .PP
 25 058b0118 2005-01-03 devnull The macro requests are defined below.
 26 058b0118 2005-01-03 devnull Many
 27 058b0118 2005-01-03 devnull .I nroff
 28 058b0118 2005-01-03 devnull and
 29 058b0118 2005-01-03 devnull .I troff
 30 058b0118 2005-01-03 devnull requests are unsafe in conjunction with
 31 058b0118 2005-01-03 devnull this package, but the following requests may be used with
 32 058b0118 2005-01-03 devnull impunity after the first
 33 058b0118 2005-01-03 devnull .BR .PP :
 34 058b0118 2005-01-03 devnull .LR .bp ,
 35 058b0118 2005-01-03 devnull .LR .br ,
 36 058b0118 2005-01-03 devnull .LR .sp ,
 37 058b0118 2005-01-03 devnull .LR .ls ,
 38 058b0118 2005-01-03 devnull .LR .na .
 39 058b0118 2005-01-03 devnull .PP
 40 058b0118 2005-01-03 devnull Output of the
 41 d32deab1 2020-08-16 rsc .MR eqn (1) ,
 42 d32deab1 2020-08-16 rsc .MR tbl (1) ,
 43 d32deab1 2020-08-16 rsc .MR pic (1)
 44 058b0118 2005-01-03 devnull and
 45 d32deab1 2020-08-16 rsc .MR grap (1)
 46 058b0118 2005-01-03 devnull preprocessors
 47 058b0118 2005-01-03 devnull for equations, tables, pictures, and graphs is acceptable as input.
 48 058b0118 2005-01-03 devnull .SH FILES
 49 c8b6342d 2005-01-13 devnull .B \*9/tmac/tmac.s
 50 058b0118 2005-01-03 devnull .SH "SEE ALSO"
 51 058b0118 2005-01-03 devnull .br
 52 058b0118 2005-01-03 devnull M. E. Lesk,
 53 058b0118 2005-01-03 devnull ``Typing Documents on the UNIX System: Using the \-ms Macros with Troff and Nroff'',
 54 058b0118 2005-01-03 devnull .I
 55 058b0118 2005-01-03 devnull Unix Research System Programmer's Manual,
 56 058b0118 2005-01-03 devnull Tenth Edition, Volume 2.
 57 058b0118 2005-01-03 devnull .br
 58 058b0118 2005-01-03 devnull .IR eqn (1), 
 59 058b0118 2005-01-03 devnull .IR troff (1), 
 60 d32deab1 2020-08-16 rsc .MR tbl (1) ,
 61 d32deab1 2020-08-16 rsc .MR pic (1)
 62 058b0118 2005-01-03 devnull .SH REQUESTS
 63 058b0118 2005-01-03 devnull .ta \w'..ND \fIdate\fR 'u +\w'Initial 'u +\w'Cause 'u
 64 058b0118 2005-01-03 devnull .br
 65 058b0118 2005-01-03 devnull .di x
 66 058b0118 2005-01-03 devnull 			\ka
 67 058b0118 2005-01-03 devnull .br
 68 058b0118 2005-01-03 devnull .di
 69 058b0118 2005-01-03 devnull .in \nau
 70 058b0118 2005-01-03 devnull .ti0
 71 058b0118 2005-01-03 devnull Request	Initial	Cause	Explanation
 72 058b0118 2005-01-03 devnull .ti0
 73 058b0118 2005-01-03 devnull 	Value	Break
 74 058b0118 2005-01-03 devnull .br
 75 058b0118 2005-01-03 devnull .in \nau
 76 058b0118 2005-01-03 devnull .ti0
 77 058b0118 2005-01-03 devnull \fL\&.1C\fP	yes	yes	One column format on a new page.
 78 058b0118 2005-01-03 devnull .ti0
 79 058b0118 2005-01-03 devnull \fL\&.2C\fP	no	yes	Two column format.
 80 058b0118 2005-01-03 devnull .ti0
 81 058b0118 2005-01-03 devnull \fL\&.AB\fP	no	yes	Begin abstract.
 82 058b0118 2005-01-03 devnull .ti0
 83 058b0118 2005-01-03 devnull \fL\&.AE\fP	-	yes	End abstract.
 84 058b0118 2005-01-03 devnull .ti0
 85 058b0118 2005-01-03 devnull \fL\&.AI\fP	no	yes	Author's institution follows.
 86 058b0118 2005-01-03 devnull Suppressed in
 87 058b0118 2005-01-03 devnull .BR .TM .
 88 058b0118 2005-01-03 devnull .ti0
 89 058b0118 2005-01-03 devnull \fL\&.AT\fP	no	yes	Print `Attached' and turn off line filling.
 90 058b0118 2005-01-03 devnull .ti0
 91 058b0118 2005-01-03 devnull \fL\&.AU\fP\fP\fP \fIx y\fR	no	yes	Author's name follows.
 92 058b0118 2005-01-03 devnull .IR x " is location and " y " is"
 93 058b0118 2005-01-03 devnull extension, ignored except in
 94 058b0118 2005-01-03 devnull .BR TM .
 95 058b0118 2005-01-03 devnull .ti0
 96 058b0118 2005-01-03 devnull \fL\&.B\fP \fIx y\fR	no	no	Print
 97 058b0118 2005-01-03 devnull .I x
 98 058b0118 2005-01-03 devnull in boldface, append
 99 058b0118 2005-01-03 devnull .IR y ;
100 058b0118 2005-01-03 devnull if no argument switch to boldface.
101 058b0118 2005-01-03 devnull .ti0
102 058b0118 2005-01-03 devnull \fL\&.B1\fP	no	yes	Begin text to be enclosed in a box.
103 058b0118 2005-01-03 devnull .ti0
104 058b0118 2005-01-03 devnull \fL\&.B2\fP	no	yes	End boxed text.
105 058b0118 2005-01-03 devnull .ti0
106 058b0118 2005-01-03 devnull \fL\&.BI\fP \fIx y\fR	no	no	Print
107 058b0118 2005-01-03 devnull .I x
108 058b0118 2005-01-03 devnull in bold italic and append
109 058b0118 2005-01-03 devnull .IR y ;
110 058b0118 2005-01-03 devnull if no argument switch to bold italic.
111 058b0118 2005-01-03 devnull .ti0
112 058b0118 2005-01-03 devnull \fL\&.BT\fP	date	no	Bottom title, automatically invoked at
113 058b0118 2005-01-03 devnull foot of page.
114 058b0118 2005-01-03 devnull May be redefined.
115 058b0118 2005-01-03 devnull .ti0
116 058b0118 2005-01-03 devnull \fL\&.BX\fP \fIx\fR	no	no	Print
117 058b0118 2005-01-03 devnull .I x
118 058b0118 2005-01-03 devnull in a box.
119 058b0118 2005-01-03 devnull .ti0
120 058b0118 2005-01-03 devnull \fL\&.CW\fP \fIx y\fR	no	no	Constant width font for
121 058b0118 2005-01-03 devnull .IR x ,
122 058b0118 2005-01-03 devnull append
123 058b0118 2005-01-03 devnull .IR y ;
124 058b0118 2005-01-03 devnull if no argument switch to constant width.
125 058b0118 2005-01-03 devnull .ti0
126 058b0118 2005-01-03 devnull \fL\&.CT\fP	no	yes	Print `Copies to' and turn off line filling.
127 058b0118 2005-01-03 devnull .ti0
128 058b0118 2005-01-03 devnull \fL\&.DA\fP \fIx\fR	nroff	no	`Date line' at bottom of page
129 058b0118 2005-01-03 devnull is
130 058b0118 2005-01-03 devnull .IR x .
131 058b0118 2005-01-03 devnull Default is today.
132 058b0118 2005-01-03 devnull .ti0
133 058b0118 2005-01-03 devnull \fL\&.DE\fP	-	yes	End displayed text.
134 058b0118 2005-01-03 devnull Implies
135 058b0118 2005-01-03 devnull .BR .KE .
136 058b0118 2005-01-03 devnull .ti0
137 058b0118 2005-01-03 devnull \fL\&.DS\fP \fIx\fR	no	yes	Start of displayed text,
138 058b0118 2005-01-03 devnull to appear verbatim line-by-line:
139 058b0118 2005-01-03 devnull .L I
140 058b0118 2005-01-03 devnull indented (default),
141 058b0118 2005-01-03 devnull .L L
142 058b0118 2005-01-03 devnull left-justified,
143 058b0118 2005-01-03 devnull .L C
144 058b0118 2005-01-03 devnull centered,
145 058b0118 2005-01-03 devnull .L B
146 058b0118 2005-01-03 devnull (block) centered with straight left margin.
147 058b0118 2005-01-03 devnull Implies
148 058b0118 2005-01-03 devnull .BR .KS .
149 058b0118 2005-01-03 devnull .ti0
150 058b0118 2005-01-03 devnull \fL\&.EG\fP	no	-	Print document in BTL format for `Engineer's Notes.'  Must be first.
151 058b0118 2005-01-03 devnull .ti0
152 058b0118 2005-01-03 devnull \fL\&.EN\fP	-	yes	Space after equation
153 058b0118 2005-01-03 devnull produced by
154 058b0118 2005-01-03 devnull .I neqn
155 058b0118 2005-01-03 devnull or
156 d32deab1 2020-08-16 rsc .MR eqn (1) .
157 058b0118 2005-01-03 devnull .ti0
158 058b0118 2005-01-03 devnull \fL\&.EQ\fP \fIx y\fR	-	yes	Display equation.
159 058b0118 2005-01-03 devnull Equation number is
160 058b0118 2005-01-03 devnull .IR y .
161 058b0118 2005-01-03 devnull Optional 
162 058b0118 2005-01-03 devnull .I x
163 058b0118 2005-01-03 devnull is
164 058b0118 2005-01-03 devnull .BR I ", " L ", " C
165 058b0118 2005-01-03 devnull as in
166 058b0118 2005-01-03 devnull .BR .DS .
167 058b0118 2005-01-03 devnull .ti0
168 058b0118 2005-01-03 devnull \fL\&.FE\fP	-	yes	End footnote.
169 058b0118 2005-01-03 devnull .ti0
170 058b0118 2005-01-03 devnull \fL\&.FP\fP \fIx\fR	-	no	Set font positions for a family, e.g.,
171 b6372b09 2006-03-20 devnull .L .FP luxisans
172 058b0118 2005-01-03 devnull .ti0
173 058b0118 2005-01-03 devnull \fL\&.FS\fP	no	no	Start footnote.
174 058b0118 2005-01-03 devnull The note will be moved to the bottom of the page.
175 058b0118 2005-01-03 devnull .ti0
176 058b0118 2005-01-03 devnull \fL\&.HO\fP	-	no	`Bell Laboratories, Holmdel,
177 058b0118 2005-01-03 devnull New Jersey 07733'.
178 058b0118 2005-01-03 devnull .ti0
179 058b0118 2005-01-03 devnull \fL\&.I\fP \fIx y\fR	no	no	Italicize
180 058b0118 2005-01-03 devnull .IR x ,
181 058b0118 2005-01-03 devnull append
182 058b0118 2005-01-03 devnull .IR y ;
183 058b0118 2005-01-03 devnull if no argument switch to italic.
184 058b0118 2005-01-03 devnull .ti0
185 058b0118 2005-01-03 devnull \fL\&.IH\fP	no	no	`Bell Laboratories, Naperville, Illinois 60540'
186 058b0118 2005-01-03 devnull .ti0
187 058b0118 2005-01-03 devnull \fL\&.IM\fP	no	no	Print document in BTL format for an internal memorandum.  Must be first.
188 058b0118 2005-01-03 devnull .ti0
189 058b0118 2005-01-03 devnull \fL\&.IP\fP \fIx y\fR	no	yes	Start indented paragraph,
190 058b0118 2005-01-03 devnull with hanging tag
191 058b0118 2005-01-03 devnull .IR x .
192 058b0118 2005-01-03 devnull Indentation is
193 058b0118 2005-01-03 devnull .I y
194 058b0118 2005-01-03 devnull ens (default 5).
195 058b0118 2005-01-03 devnull .ti0
196 058b0118 2005-01-03 devnull \fL\&.KE\fP	-	yes	End keep.
197 058b0118 2005-01-03 devnull Put kept text on next page if not enough room.
198 058b0118 2005-01-03 devnull .ti0
199 058b0118 2005-01-03 devnull \fL\&.KF\fP	no	yes	Start floating keep.
200 058b0118 2005-01-03 devnull If the kept text must be moved to the next page,
201 058b0118 2005-01-03 devnull float later text back to this page.
202 058b0118 2005-01-03 devnull .ti0
203 058b0118 2005-01-03 devnull \fL\&.KS\fP	no	yes	Start keeping following text.
204 058b0118 2005-01-03 devnull .ti0
205 058b0118 2005-01-03 devnull \fL\&.LG\fP	no	no	Make letters larger.
206 058b0118 2005-01-03 devnull .ti0
207 058b0118 2005-01-03 devnull \fL\&.LP\fP	yes	yes	Start left-blocked paragraph.
208 058b0118 2005-01-03 devnull .ti0
209 058b0118 2005-01-03 devnull \fL\&.LT\fP	no	yes	Start a letter; a non-empty first argument
210 058b0118 2005-01-03 devnull produces a full Lucent letterhead, a second argument is a room number,
211 058b0118 2005-01-03 devnull a third argument is a telephone number.
212 058b0118 2005-01-03 devnull .ti0
213 058b0118 2005-01-03 devnull \fL\&.MF\fP	-	-	Print document in BTL format for `Memorandum for File.'  Must be first.
214 058b0118 2005-01-03 devnull .ti0
215 058b0118 2005-01-03 devnull \fL\&.MH\fP	-	no	`Bell Laboratories, Murray Hill,
216 058b0118 2005-01-03 devnull New Jersey 07974'.
217 058b0118 2005-01-03 devnull .ti0
218 058b0118 2005-01-03 devnull \fL\&.MR\fP	-	-	Print document in BTL format for `Memorandum for Record.'  Must be first.
219 058b0118 2005-01-03 devnull .ti0
220 058b0118 2005-01-03 devnull \fL\&.ND\fP \fIdate\fR	troff	no	Use date supplied (if any) only in
221 058b0118 2005-01-03 devnull special BTL format positions; omit from page footer.
222 058b0118 2005-01-03 devnull .ti0
223 058b0118 2005-01-03 devnull \fL\&.NH\fP \fIn\fR	-	yes	Same as
224 058b0118 2005-01-03 devnull .BR .SH ,
225 058b0118 2005-01-03 devnull with automatic section
226 058b0118 2005-01-03 devnull numbers  like `1.2.3';
227 058b0118 2005-01-03 devnull .I n
228 058b0118 2005-01-03 devnull is subsection level (default 1).
229 058b0118 2005-01-03 devnull .ti0
230 058b0118 2005-01-03 devnull \fL\&.NL\fP	yes	no	Make letters normal size.
231 058b0118 2005-01-03 devnull .ti0
232 058b0118 2005-01-03 devnull \fL\&.P1\fP	-	yes	Begin program display in constant width font.
233 058b0118 2005-01-03 devnull .ti0
234 058b0118 2005-01-03 devnull \fL\&.P2\fP	-	yes	End program display.
235 058b0118 2005-01-03 devnull .ti0
236 058b0118 2005-01-03 devnull \fL\&.PE\fP	-	yes	End picture; see
237 d32deab1 2020-08-16 rsc .MR pic (1) .
238 058b0118 2005-01-03 devnull .ti0
239 058b0118 2005-01-03 devnull \fL\&.PF\fP	-	yes	End picture; restore vertical
240 058b0118 2005-01-03 devnull position.
241 058b0118 2005-01-03 devnull .ti0
242 058b0118 2005-01-03 devnull \fL\&.PP\fP	no	yes	Begin paragraph.
243 058b0118 2005-01-03 devnull First line indented.
244 058b0118 2005-01-03 devnull .ti0
245 058b0118 2005-01-03 devnull \fL\&.PS\fP \fIh w\fR	-	yes	Start picture; height
246 058b0118 2005-01-03 devnull and width in inches.
247 058b0118 2005-01-03 devnull .ti0
248 058b0118 2005-01-03 devnull \fL\&.PY\fP	-	no	`Bell Laboratories, Piscataway, New Jersey 08854'
249 058b0118 2005-01-03 devnull .ti0
250 058b0118 2005-01-03 devnull \fL\&.QE\fP	-	yes	End quoted material.
251 058b0118 2005-01-03 devnull .ti0
252 058b0118 2005-01-03 devnull \fL\&.QP\fP	-	yes	Begin quoted paragraph (indent both margins).
253 058b0118 2005-01-03 devnull .ti0
254 058b0118 2005-01-03 devnull \fL\&.QS\fP	-	yes	Begin quoted material (indent both margins).
255 058b0118 2005-01-03 devnull .ti0
256 058b0118 2005-01-03 devnull \fL\&.R\fP	yes	no	Roman text follows.
257 058b0118 2005-01-03 devnull .ti0
258 058b0118 2005-01-03 devnull \fL\&.RE\fP	-	yes	End relative indent level.
259 058b0118 2005-01-03 devnull .ti0
260 058b0118 2005-01-03 devnull \fL\&.RP\fP	no	-	Cover sheet and first page for released
261 058b0118 2005-01-03 devnull paper.
262 058b0118 2005-01-03 devnull Must precede other requests.
263 058b0118 2005-01-03 devnull .ti0
264 058b0118 2005-01-03 devnull \fL\&.RS\fP	-	yes	Start level of relative indentation
265 058b0118 2005-01-03 devnull from which subsequent indentation is measured.
266 058b0118 2005-01-03 devnull .ti0
267 058b0118 2005-01-03 devnull \fL\&.SG\fP \fIx\fR	no	yes	Insert signature(s) of author(s),
268 058b0118 2005-01-03 devnull ignored except in 
269 058b0118 2005-01-03 devnull .B .TM
270 058b0118 2005-01-03 devnull and
271 058b0118 2005-01-03 devnull .BR .LT .
272 058b0118 2005-01-03 devnull .IR x " is the reference line (initials of author and typist)."
273 058b0118 2005-01-03 devnull .ti0
274 058b0118 2005-01-03 devnull \fL\&.SH\fP	-	yes	Section head follows,
275 058b0118 2005-01-03 devnull font automatically bold.
276 058b0118 2005-01-03 devnull .ti0
277 058b0118 2005-01-03 devnull \fL\&.SM\fP	no	no	Make letters smaller.
278 058b0118 2005-01-03 devnull .ti0
279 058b0118 2005-01-03 devnull \fL\&.TA\fP\ \fIx\fR...	5...	no	Set tabs in ens.
280 058b0118 2005-01-03 devnull Default is 5 10 15 ...
281 058b0118 2005-01-03 devnull .ti0
282 058b0118 2005-01-03 devnull \fL\&.TE\fP	-	yes	End table; see
283 d32deab1 2020-08-16 rsc .MR tbl (1) .
284 058b0118 2005-01-03 devnull .ti0
285 058b0118 2005-01-03 devnull \fL\&.TH\fP	-	yes	End heading section of table.
286 058b0118 2005-01-03 devnull .ti0
287 058b0118 2005-01-03 devnull \fL\&.TL\fP	no	yes	Title follows.
288 058b0118 2005-01-03 devnull .ti0
289 058b0118 2005-01-03 devnull \fL\&.TM\fP\ \fIx\fR...	no	-	Print document in BTL technical memorandum format.
290 058b0118 2005-01-03 devnull Arguments are TM number, (quoted list of) case number(s), and file number.
291 058b0118 2005-01-03 devnull Must precede other requests.
292 058b0118 2005-01-03 devnull .ti0
293 058b0118 2005-01-03 devnull \fL\&.TR\fP \fIx\fR	-	-	Print in BTL technical report format; report number is \fIx\fR.  Must be first.
294 058b0118 2005-01-03 devnull .ti0
295 058b0118 2005-01-03 devnull \fL\&.TS\fP \fIx\fR	-	yes	Begin table; if
296 058b0118 2005-01-03 devnull .I x
297 058b0118 2005-01-03 devnull is
298 058b0118 2005-01-03 devnull .B H
299 058b0118 2005-01-03 devnull table heading is repeated on new pages.
300 058b0118 2005-01-03 devnull .ti0
301 058b0118 2005-01-03 devnull \fL\&.UL\fP \fIx\fR	-	no	Underline argument (even in troff).
302 058b0118 2005-01-03 devnull .ti0
303 058b0118 2005-01-03 devnull \fL\&.UX\fP\ \fIy z\fP	-	no	`\fIz\fRUNIX\fIy\fP';
304 058b0118 2005-01-03 devnull first use gives registered trademark notice.
305 058b0118 2005-01-03 devnull .ti0
306 058b0118 2005-01-03 devnull \fL\&.WH\fP	-	no	`Bell Laboratories, Whippany,
307 058b0118 2005-01-03 devnull New Jersey 07981'.
308 058b0118 2005-01-03 devnull .hc