| 1 | .hc % |
| 2 | .TH MS 7 |
| 3 | .SH NAME |
| 4 | ms \- macros for formatting manuscripts |
| 5 | .SH SYNOPSIS |
| 6 | .B "nroff \-ms" |
| 7 | [ options ] |
| 8 | file ... |
| 9 | .br |
| 10 | .B "troff \-ms" |
| 11 | [ options ] |
| 12 | file ... |
| 13 | .SH DESCRIPTION |
| 14 | This package of |
| 15 | .I nroff |
| 16 | and |
| 17 | .I troff |
| 18 | macro definitions provides a canned formatting |
| 19 | .li |
| 20 | facility for tech%nical papers in various formats. |
| 21 | When producing 2-column output on a terminal, filter |
| 22 | the output through |
| 23 | .IR col (1). |
| 24 | .PP |
| 25 | The macro requests are defined below. |
| 26 | Many |
| 27 | .I nroff |
| 28 | and |
| 29 | .I troff |
| 30 | requests are unsafe in conjunction with |
| 31 | this package, however these requests may be used with |
| 32 | impunity after the first .PP: |
| 33 | .IP |
| 34 | .ta \w'.sp n 'u |
| 35 | .li |
| 36 | .bp begin new page |
| 37 | .nf |
| 38 | .li |
| 39 | .br break output line here |
| 40 | .li |
| 41 | .sp n insert n spacing lines |
| 42 | .li |
| 43 | .ls n (line spacing) n=1 single, n=2 double space |
| 44 | .li |
| 45 | .na no alignment of right margin |
| 46 | .fi |
| 47 | .PP |
| 48 | Output of the |
| 49 | .I eqn, |
| 50 | .I neqn, |
| 51 | .I refer, |
| 52 | and |
| 53 | .IR tbl (1) |
| 54 | preprocessors |
| 55 | for equations and tables is acceptable as input. |
| 56 | .SH FILES |
| 57 | /usr/lib/tmac/tmac.s |
| 58 | .SH "SEE ALSO" |
| 59 | eqn(1), troff(1), refer(1), tbl(1) |
| 60 | .tr &. |
| 61 | .SH REQUESTS |
| 62 | .ta \w'..ND \fIdate\fR 'u +\w'Initial 'u +\w'Cause 'u |
| 63 | .br |
| 64 | .di x |
| 65 | \ka |
| 66 | .br |
| 67 | .di |
| 68 | .in \nau |
| 69 | .ti0 |
| 70 | Request Initial Cause Explanation |
| 71 | .ti0 |
| 72 | Value Break |
| 73 | .br |
| 74 | .in \nau |
| 75 | .ti0 |
| 76 | .li |
| 77 | .1C yes yes One column format on a new page. |
| 78 | .ti0 |
| 79 | .li |
| 80 | .2C no yes Two column format. |
| 81 | .ti0 |
| 82 | .li |
| 83 | .AB no yes Begin abstract. |
| 84 | .ti0 |
| 85 | .li |
| 86 | .AE - yes End abstract. |
| 87 | .ti0 |
| 88 | .li |
| 89 | .AI no yes Author's institution follows. |
| 90 | Suppressed in TM. |
| 91 | .ti0 |
| 92 | .li |
| 93 | .AT no yes Print `\ 1Attached' and turn off line filling. |
| 94 | .ti0 |
| 95 | .li |
| 96 | .AU \fIx y\fR no yes Author's name follows. |
| 97 | .IR x " is location and " "y\fR is" |
| 98 | extension, ignored except in TM. |
| 99 | .ti0 |
| 100 | .li |
| 101 | .B \fIx\fR no no Print \fIx\fR in boldface; if no argument switch to boldface. |
| 102 | .ti 0 |
| 103 | .li |
| 104 | .B1 no yes Begin text to be enclosed in a box. |
| 105 | .ti0 |
| 106 | .li |
| 107 | .B2 no yes End text to be boxed & print it. |
| 108 | .ti0 |
| 109 | .li |
| 110 | .BT date no Bottom title, automatically invoked at |
| 111 | foot of page. |
| 112 | May be redefined. |
| 113 | .ti0 |
| 114 | .li |
| 115 | .BX \fIx\fR no no Print \fIx\fR in a box. |
| 116 | .ti0 |
| 117 | .li |
| 118 | .CS \fIx...\fR - yes Cover sheet info if |
| 119 | TM format, suppressed otherwise. |
| 120 | Arguments are number of text pages, |
| 121 | other pages, total pages, figures, tables, references. |
| 122 | .ti0 |
| 123 | .li |
| 124 | .CT no yes Print `Copies to' and enter no-fill mode. |
| 125 | .ti0 |
| 126 | .li |
| 127 | .DA \fIx\fR nroff no `Date line' at bottom of page |
| 128 | is |
| 129 | .IR x . |
| 130 | Default is today. |
| 131 | .ti0 |
| 132 | .li |
| 133 | .DE - yes End displayed text. |
| 134 | Implies .KE. |
| 135 | .ti0 |
| 136 | .li |
| 137 | .DS \fIx\fR no yes Start of displayed text, |
| 138 | to appear verbatim line-by-line. |
| 139 | .IR x "=I for indented display (default)," |
| 140 | .IR x "=L for left-justified on the page," |
| 141 | .IR x "=C for centered," |
| 142 | .IR x "=B for make left-justified block, then center whole block." |
| 143 | Implies .KS. |
| 144 | .ti0 |
| 145 | .li |
| 146 | .EG no - Print document in BTL format for `Engineer's Notes.' Must be first. |
| 147 | .ti0 |
| 148 | .li |
| 149 | .EN - yes Space after equation |
| 150 | produced by |
| 151 | .I eqn |
| 152 | or |
| 153 | .IR neqn . |
| 154 | .ti0 |
| 155 | .li |
| 156 | .EQ \fIx y\fR - yes Precede equation; break out and |
| 157 | add space. |
| 158 | Equation number is |
| 159 | .IR y . |
| 160 | The optional argument \fIx\fR |
| 161 | may be |
| 162 | .I I |
| 163 | to indent equation (default), |
| 164 | .I L |
| 165 | to left-adjust the equation, or |
| 166 | .I C |
| 167 | to center the equation. |
| 168 | .ti0 |
| 169 | .li |
| 170 | .FE - yes End footnote. |
| 171 | .ti0 |
| 172 | .li |
| 173 | .FS no no Start footnote. |
| 174 | The note will be moved to the bottom of the page. |
| 175 | .ti0 |
| 176 | .li |
| 177 | .HO - no `Bell Laboratories, Holmdel, |
| 178 | New Jersey 07733'. |
| 179 | .ti0 |
| 180 | .li |
| 181 | .I \fIx\fR no no Italicize \fIx\fR; |
| 182 | if \fIx\fR missing, italic text follows. |
| 183 | .ti0 |
| 184 | .li |
| 185 | .IH no no `Bell Laboratories, Naperville, Illinois 60540' |
| 186 | .ti0 |
| 187 | .li |
| 188 | .IM no no Print document in BTL format for an internal memorandum. Must be first. |
| 189 | .ti0 |
| 190 | .li |
| 191 | .IP \fIx y\fR no yes Start indented paragraph, |
| 192 | with hanging tag |
| 193 | .IR x . |
| 194 | Indentation is |
| 195 | .IR y "" |
| 196 | ens (default 5). |
| 197 | .ti0 |
| 198 | .li |
| 199 | .KE - yes End keep. |
| 200 | Put kept text on next page if not enough room. |
| 201 | .ti0 |
| 202 | .li |
| 203 | .KF no yes Start floating keep. |
| 204 | If the kept text must be moved to the next page, |
| 205 | float later text back to this page. |
| 206 | .ti0 |
| 207 | .li |
| 208 | .KS no yes Start keeping following text. |
| 209 | .ti0 |
| 210 | .li |
| 211 | .LG no no Make letters larger. |
| 212 | .ti0 |
| 213 | .li |
| 214 | .LP yes yes Start left-blocked paragraph. |
| 215 | .ti0 |
| 216 | .li |
| 217 | .MF - - Print document in BTL format for `Memorandum for File.' Must be first. |
| 218 | .ti0 |
| 219 | .li |
| 220 | .MH - no `Bell Laboratories, Murray Hill, |
| 221 | New Jersey 07974'. |
| 222 | .ti0 |
| 223 | .li |
| 224 | .MR - - Print document in BTL format for `Memorandum for Record.' Must be first. |
| 225 | .ti0 |
| 226 | .li |
| 227 | .ND \fIdate\fR troff no Use date supplied (if any) only in |
| 228 | special BTL format positions; omit from page footer. |
| 229 | .ti0 |
| 230 | .li |
| 231 | .NH \fIn\fR - yes Same as .SH, with section |
| 232 | number supplied automatically. |
| 233 | Numbers are multilevel, like 1.2.3, |
| 234 | where |
| 235 | .IR n "" |
| 236 | tells what level is wanted (default is 1). |
| 237 | .ti0 |
| 238 | .li |
| 239 | .NL yes no Make letters normal size. |
| 240 | .ti0 |
| 241 | .li |
| 242 | .OK - yes `Other keywords' for TM cover |
| 243 | sheet follow. |
| 244 | .ti0 |
| 245 | .li |
| 246 | .PP no yes Begin paragraph. |
| 247 | First line indented. |
| 248 | .ti0 |
| 249 | .li |
| 250 | .PT pg # - Page title, automatically invoked at |
| 251 | top of page. |
| 252 | May be redefined. |
| 253 | .ti0 |
| 254 | .li |
| 255 | .PY - no `Bell Laboratories, Piscataway, New Jersey 08854' |
| 256 | .ti0 |
| 257 | .li |
| 258 | .QE - yes End quoted (indented and shorter) material. |
| 259 | .ti0 |
| 260 | .li |
| 261 | .QP - yes Begin single paragraph which is indented and shorter. |
| 262 | .ti0 |
| 263 | .li |
| 264 | .QS - yes Begin quoted (indented and shorter) material. |
| 265 | .ti0 |
| 266 | .li |
| 267 | .R yes no Roman text follows. |
| 268 | .ti0 |
| 269 | .li |
| 270 | .RE - yes End relative indent level. |
| 271 | .ti0 |
| 272 | .li |
| 273 | .RP no - Cover sheet and first page for released |
| 274 | paper. |
| 275 | Must precede other requests. |
| 276 | .ti0 |
| 277 | .li |
| 278 | .RS - yes Start level of relative indentation. |
| 279 | Following .IP's are measured from current indentation. |
| 280 | .ti0 |
| 281 | .li |
| 282 | .SG \fIx\fR no yes Insert signature(s) of author(s), |
| 283 | ignored except in TM. |
| 284 | .IR x " is the reference line (initials of author and typist)." |
| 285 | .ti0 |
| 286 | .li |
| 287 | .SH - yes Section head follows, |
| 288 | font automatically bold. |
| 289 | .ti0 |
| 290 | .li |
| 291 | .SM no no Make letters smaller. |
| 292 | .ti0 |
| 293 | .li |
| 294 | .TA \fIx\fR... 5... no Set tabs in ens. |
| 295 | Default is 5 10 15 ... |
| 296 | .ti0 |
| 297 | .li |
| 298 | .TE - yes End table. |
| 299 | .ti0 |
| 300 | .li |
| 301 | .TH - yes End heading section of table. |
| 302 | .ti0 |
| 303 | .li |
| 304 | .TL no yes Title follows. |
| 305 | .ti0 |
| 306 | .li |
| 307 | .TM \fIx\fR... no - Print document in BTL technical memorandum format. |
| 308 | Arguments are TM number, (quoted list of) case number(s), and file number. |
| 309 | Must precede other requests. |
| 310 | .ti0 |
| 311 | .li |
| 312 | .TR \fIx\fR - - Print in BTL technical report format; report number is \fIx\fR. Must be first. |
| 313 | .ti0 |
| 314 | .li |
| 315 | .TS \fIx\fR - yes Begin table; if \fIx\fR is |
| 316 | .I H |
| 317 | table has repeated heading. |
| 318 | .ti0 |
| 319 | .li |
| 320 | .UL \fIx\fR - no Underline argument (even in troff). |
| 321 | .ti0 |
| 322 | .li |
| 323 | .UX - no `UNIX'; first time used, add footnote `UNIX is a trademark of |
| 324 | Bell Laboratories.' |
| 325 | .ti0 |
| 326 | .li |
| 327 | .WH - no `Bell Laboratories, Whippany, |
| 328 | New Jersey 07981'. |