~ubuntu-branches/ubuntu/dapper/groff/dapper

« back to all changes in this revision

Viewing changes to contrib/mm/groff_mm.man

  • Committer: Bazaar Package Importer
  • Author(s): Colin Watson
  • Date: 2002-03-17 04:11:50 UTC
  • Revision ID: james.westby@ubuntu.com-20020317041150-wkgfawjc3gxlk0o5
Tags: upstream-1.17.2
Import upstream version 1.17.2

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.\"
 
2
.\" $Id: groff_mm.man,v 2.2 2001/06/27 12:47:16 wlemb Exp $
 
3
.\"
 
4
.de T2
 
5
.ne 2v
 
6
.ti -.5i
 
7
\\$1
 
8
.sp -1
 
9
..
 
10
.de T3
 
11
.ne 2v
 
12
.ti -.5i
 
13
\fB\\$1\fP
 
14
.br
 
15
..
 
16
.TH GROFF_MM @MAN7EXT@ "@MDATE@" "Groff Version @VERSION@"
 
17
.SH NAME
 
18
groff_mm \- groff mm macros
 
19
.SH SYNOPSIS
 
20
.B groff
 
21
.B \-m@TMAC_M_PREFIX@m
 
22
[
 
23
.IR options .\|.\|.
 
24
]
 
25
[
 
26
.IR files .\|.\|.
 
27
]
 
28
.SH DESCRIPTION
 
29
The groff mm macros are intended to be compatible with the DWB mm macros
 
30
with the following limitations:
 
31
.TP
 
32
.B \(bu
 
33
no Bell Labs localisms implemented.
 
34
.TP
 
35
.B \(bu
 
36
the macros OK and PM is not implemented.
 
37
.TP
 
38
.B \(bu
 
39
groff mm does not support cut marks
 
40
.LP
 
41
\fBm@TMAC_M_PREFIX@m\fP is intended to be international. Therefore it is 
 
42
possible to write short national macrofiles which change all
 
43
english text to the preferred language. Use \fBm@TMAC_M_PREFIX@mse\fP as an example.
 
44
.\"########################################################################
 
45
.LP
 
46
A file called \fBlocale\fP or \fIlang\fP\fB_locale\fP is read
 
47
after the initiation of the global variables. It is therefore
 
48
possible to localize the macros with companyname and so on.
 
49
.sp
 
50
In this manual square brackets is used to show optional arguments.
 
51
.sp 3
 
52
\fBNumber registers and strings\fP
 
53
.br
 
54
Many macros can be controlled by number registers and strings.
 
55
A number register is assigned with the \fBnr\fP command:
 
56
.br
 
57
\fB\&.nr\fP \fIXXX\fP \fI[+-]n [i]\fP
 
58
.br
 
59
\fBXXX\fP is the name of the register, \fBn\fP is the value to
 
60
be assigned, and \fBi\fP is increment value for auto-increment.
 
61
\fBn\fP can have a plus or minus sign as prefix if an increment
 
62
or decrement of the current value is wanted. (Auto-increment or decrement
 
63
occurs if the number register is used with a plus or minus sign,
 
64
\fB\en+[XXX]\fP or \fB\en-[XXX]\fP.)
 
65
.sp
 
66
Strings is defined with \fBds\fP.
 
67
.br
 
68
\fB\&.ds\fP \fIYYY string\fP
 
69
.br
 
70
The string is assigned everything to the end of the line, even blanks.
 
71
Initial blanks in \fIstring\fP should be prefixed with
 
72
a double-quote. (Strings are used in the text as \fB\e*[YYY]\fP.)
 
73
.sp
 
74
\fBSpecial formatting of number registers\fP
 
75
.br
 
76
A number register is printed with normal digits if no format has been
 
77
given.
 
78
Set the format with \fBaf\fP:
 
79
.br
 
80
\fB\&.af\fP \fIR c\fP
 
81
.br
 
82
\fIR\fP is the name of the register, \fIc\fP is the format.
 
83
.in +.5i
 
84
.T2 \fBForm\fP
 
85
\fBSequence\fP
 
86
.T2 1
 
87
0, 1, 2, 3, ...
 
88
.T2 001
 
89
000, 001, 002, 003, ...
 
90
.T2 i
 
91
0, i, ii, iii, iv, ...
 
92
.T2 I
 
93
0, I, II, III, IV, ...
 
94
.T2 a
 
95
0, a, b, c, ..., z, aa, ab, ...
 
96
.T2 A
 
97
0, A, B, C, ..., Z, AA, AB, ...
 
98
.in
 
99
 
 
100
.LP
 
101
\fBMacros:\fP
 
102
.TP
 
103
.B ")E level text"
 
104
Adds \fBtext\fP (heading-text) to the table of contents
 
105
with \fBlevel\fP either 0
 
106
or between 1-7. See also \fB.H\fP. This macro is used for customized
 
107
table of contents.
 
108
.TP
 
109
.B "1C [1]"
 
110
Begin one column processing. An \fB1\fP as argument disables the page-break.
 
111
Use wide footnotes, small footnotes may be overprinted.
 
112
.TP
 
113
.B 2C
 
114
Begin two column processing. Splits the page in two columns. It is
 
115
a special case of \fBMC\fP. See also \fB1C\fP.
 
116
.TP
 
117
.B AE
 
118
Abstract end, see \fBAS\fP.
 
119
.TP
 
120
.B "AF [name of firm]"
 
121
Authors firm, should be called before \fBAU\fP, see also \fBCOVER\fP.
 
122
.TP
 
123
.B "AL [type [text-indent [1]]]"
 
124
Start autoincrement list. Items are numbered beginning on one.
 
125
The \fItype\fP argument controls the type of numbers.
 
126
.in +.5i
 
127
.T2 Arg
 
128
Description
 
129
.T2 1
 
130
Arabic (the default)
 
131
.T2 A
 
132
Upper-case letters (A-Z)
 
133
.T2 a
 
134
Lower-case letters (a-z)
 
135
.T2 I
 
136
Upper-case roman
 
137
.T2 i
 
138
Lower-case roman
 
139
.in
 
140
\fIText-indent\fP sets the indent and overrides \fBLi\fP.
 
141
A third argument will prohibit printing of a blank line before each
 
142
item.
 
143
.TP
 
144
.B "APP name text"
 
145
Begin an appendix with name \fIname\fP. Automatic naming occurs if
 
146
\fIname\fP is "". The appendixes starts with \fBA\fP if auto is used.
 
147
An new page is ejected, and a header is also produced if the number
 
148
variable \fBAph\fP is non-zero. This is the default.
 
149
The appendix always appear in the 'List of contents' with correct
 
150
pagenumber. The name \fIAPPENDIX\fP can be changed by setting
 
151
the string \fBApp\fP to the desired text.
 
152
The string \fBApptxt\fP contains the current appendix text.
 
153
.TP
 
154
.B "APPSK name pages text"
 
155
Same as \fB.APP\fP, but the pagenr is incremented with \fIpages\fP.
 
156
This is used when diagrams or other non-formatted documents are
 
157
included as appendixes.
 
158
.TP
 
159
.B "AS [arg [indent]]"
 
160
Abstract start. Indent is specified in 'ens', but scaling is allowed.
 
161
Argument \fIarg\fP controls where the abstract is printed.
 
162
.in +.5i
 
163
.T2 Arg
 
164
Placement
 
165
.T2 0
 
166
Abstract will be printed on page 1 and on the cover sheet if
 
167
used in the released-paper style (\fBMT 4\fP), otherwise
 
168
it will be printed on page 1 without a cover sheet.
 
169
.T2 1
 
170
Abstract will only be printed on the cover sheet (\fBMT 4\fP only).
 
171
.T2 2
 
172
Abstract will be printed only on the cover sheet (other than \fBMT 4\fP only).
 
173
The cover sheet is printed without need for \fBCS\fP.
 
174
.in
 
175
Abstract is not printed at all in external letters (\fBMT 5\fP).
 
176
The \fIindent\fP controls the indentation of both margins, otherwise
 
177
will normal text indent be used.
 
178
.TP
 
179
.B "AST [title]"
 
180
Abstract title. Default is \fBABSTRACT\fP.
 
181
Sets the text above the abstract text.
 
182
.TP
 
183
.B "AT title1 [title2 ...]"
 
184
Authors title. \fBAT\fP must appear just after each \fBAU\fP.
 
185
The title will show up after the name in the signature block.
 
186
.TP
 
187
.B "AU [name [initials [loc [dept [ext [room [arg [arg [arg]]]]]]]]]"
 
188
Author information, specifies the author of the memo or paper, and
 
189
will be printed on the cover sheet and on other similar places.
 
190
\fBAU\fP must not appear before \fBTL\fP. The author information
 
191
can contain initials, location, department, telephone extension,
 
192
room number or name and up to three extra arguments.
 
193
.TP
 
194
.B "AV [name [1]]"
 
195
Approval signature, generates an approval line with place for
 
196
signature and date. The string \fBAPPROVED:\fP can be changed
 
197
with variable \fBLetapp\fP, and the string \fBDate\fP in \fBLetdate\fP.
 
198
.TP
 
199
.B "AVL [name]"
 
200
Letter signature, generates a line with place for signature. 
 
201
.TP
 
202
.B "B [bold-text [prev-font-text [bold...]]]"
 
203
Begin boldface.
 
204
No limit on the number of arguments.
 
205
All arguments will be concatenated to one word, the first, third and so
 
206
on will be printed in boldface.
 
207
.TP
 
208
.B B1
 
209
Begin box (as the ms macro).
 
210
Draws a box around the text. The text will be indented one character,
 
211
and the right margin will be one character shorter.
 
212
.TP
 
213
.B B2
 
214
End box. Finish the box started by \fBB1\fP.
 
215
.TP
 
216
.B BE
 
217
End bottom block, see \fBBS\fP.
 
218
.TP
 
219
.B "BI [bold-text [italic-text [bold-text [...]]]]"
 
220
Bold-italic.
 
221
No limit on the number of arguments, see \fBB\fP.
 
222
.TP
 
223
.B "BL [text-indent [1]]"
 
224
Start bullet list, initialize a list with a bullet and a space
 
225
in the beginning of each list item (see \fBLI\fP).
 
226
\fIText-indent\fP
 
227
overrides the default indentation of the list items set by
 
228
number register \fBPi\fP.
 
229
A third argument will prohibit printing of a blank line before each
 
230
item.
 
231
.TP
 
232
.B "BR [bold-text [roman-text [bold-text [...]]]]"
 
233
Bold-roman.
 
234
No limit on the number of arguments.
 
235
.TP
 
236
.B BS
 
237
Bottom block start. Begins the definition of a text block which is
 
238
printed at the bottom of each page. Block ends with \fBBE\fP.
 
239
.TP
 
240
.B "BVL text-indent [mark-indent [1]]"
 
241
Start of 
 
242
broken variable-item list.
 
243
Broken variable-item list has no fixed mark, it assumes that
 
244
every \fBLI\fP has a mark instead.
 
245
The text will always begin at the next line after the mark.
 
246
\fIText-indent\fP sets the indent to the text, and \fImark-indent\fP
 
247
the distance from the current indent to the mark.
 
248
A third argument will prohibit printing of a blank line before each
 
249
item.
 
250
.TP
 
251
.B "COVER [arg]"
 
252
\&\fBCOVER\fP begins a coversheet definition. It is important
 
253
that \fB.COVER\fP appears before any normal text.
 
254
\&\fB.COVER\fP uses \fIarg\fP to build the filename 
 
255
@TMAC_MDIR@/\fIarg\fP.cov. Therefore it is possible to create unlimited
 
256
types of coversheets.
 
257
\fIms.cov\fP is supposed to look like the \fBms\fP coversheet.
 
258
\&\fB.COVER\fP requires a \fB.COVEND\fP at the end of the coverdefinition.
 
259
Always use this order of the covermacros:
 
260
.nf
 
261
\&.COVER
 
262
\&.TL
 
263
\&.AF
 
264
\&.AU
 
265
\&.AT
 
266
\&.AS
 
267
\&.AE
 
268
\&.COVEND
 
269
.fi
 
270
However, only \fB.TL\fP and \fB.AU\fP are required.
 
271
.TP
 
272
.B COVEND
 
273
This finish the cover description and prints the cover-page.
 
274
It is defined in the cover file.
 
275
.TP
 
276
.B DE
 
277
Display end. Ends a block of text, display, that begins
 
278
with \fBDS\fP or \fBDF\fP.
 
279
.TP
 
280
.B "DF [format [fill [rindent]]]"
 
281
Begin floating display (no nesting allowed). 
 
282
A floating display is saved in a queue and is printed in the
 
283
order entered. \fIFormat\fP, \fIfill\fP and \fIrindent\fP is the same
 
284
as in \fBDS\fP.
 
285
Floating displays are controlled by the two number registers \fBDe\fP
 
286
and \fBDf\fP.
 
287
.sp
 
288
\fBDe register\fP
 
289
.in +.5i
 
290
.T2 0
 
291
Nothing special, this is the default.
 
292
.T2 1
 
293
A page eject will occur after each printed display, giving only
 
294
one display per page and no text following it.
 
295
.in
 
296
.sp
 
297
\fBDf register\fP
 
298
.in +.5i
 
299
.T2 0
 
300
Displays are printed at the end of each section (when section-page
 
301
numbering is active) or at the end of the document.
 
302
.T2 1
 
303
A new display will be printed on the current page if there is enough
 
304
space, otherwise it will be printed at the end of the document.
 
305
.T2 2
 
306
One display will be printed at the top of each page or column
 
307
(in multi-column mode).
 
308
.T2 3
 
309
Print one display if there is enough space for it, otherwise it will
 
310
be printed at the top of the next page or column.
 
311
.T2 4
 
312
Print as many displays that will fit in a new page or column.
 
313
A page break will occur between each display if \fBDe\fP is not zero.
 
314
.T2 5
 
315
Fill the current page with displays and the rest beginning at a new page
 
316
or column. (This is the default.)
 
317
A page break will occur between each display
 
318
if \fBDe\fP is not zero.
 
319
.in
 
320
.TP
 
321
.B "DL [text-indent [1 [1]]]"
 
322
Dash list start. Begins a list where each item is printed
 
323
after a dash. \fIText-indent\fP changes the default indentation
 
324
of the list items set by
 
325
number register \fBPi\fP.
 
326
A second argument prevents the empty line between each list item
 
327
to be printed. See \fBLI\fP.
 
328
A third argument will prohibit printing of a blank line before each
 
329
item.
 
330
.TP
 
331
.B "DS [format [fill [rindent]]]"
 
332
Static display start.
 
333
Begins collection of text until \fBDE\fP.
 
334
The text is printed together on the same page, unless it is longer
 
335
than the height of the page.
 
336
\fBDS\fP can be nested to a unlimited depth (reasonably :-).
 
337
.sp
 
338
\fBformat\fP
 
339
.in +.5i
 
340
.ds x "
 
341
.T2 """"""
 
342
No indentation.
 
343
.T2 none
 
344
No indentation.
 
345
.T2 L
 
346
No indentation.
 
347
.T2 I
 
348
Indent text with the value of number register \fBSi\fP.
 
349
.T2 C
 
350
Center each line
 
351
.T2 CB
 
352
Center the whole display as a block.
 
353
.T2 R
 
354
Right adjust the lines.
 
355
.T2 RB
 
356
Right adjust the whole display as a block
 
357
.in
 
358
.sp
 
359
L, I, C and CB can also be specified as 0, 1, 2 or 3 for compatibility
 
360
reasons. (Don't use it. :-)
 
361
.sp
 
362
\fBfill\fP
 
363
.in +.5i
 
364
.T2 """"""
 
365
Line-filling turned off.
 
366
.T2 none
 
367
Line-filling turned off.
 
368
.T2 N
 
369
Line-filling turned off.
 
370
.T2 F
 
371
Line-filling turned on.
 
372
.in
 
373
.sp
 
374
N and F can also be specified as 0 or 1.
 
375
An empty line will normally be printed before and after the
 
376
display. Setting number register \fBDs\fP to 0 will prevent this.
 
377
\fIRindent\fP shortens the line length by that amount.
 
378
.TP
 
379
.B "EC [title [override [flag [refname]]]]"
 
380
Equation title.
 
381
Sets a title for an equation. The \fIoverride\fP argument
 
382
change the numbering.
 
383
.sp
 
384
\fBflag\fP
 
385
.in +.5i
 
386
.T2 none
 
387
\fIoverride\fP is a prefix to the number.
 
388
.T2 0
 
389
\fIoverride\fP is a prefix to the number.
 
390
.T2 1
 
391
\fIoverride\fP is a suffix to the number.
 
392
.T2 2
 
393
\fIoverride\fP replaces the number.
 
394
.in
 
395
\fBEC\fP uses the number register \fBEc\fP as counter.
 
396
It is possible to use \fB.af\fP to change the format of the number.
 
397
If number register \fBOf\fP is 1, then the format of title
 
398
will use a dash instead of a dot after the number.
 
399
.br
 
400
The string \fBLe\fP controls the title of the
 
401
List of Equations, default is \fILIST OF EQUATIONS\fP.
 
402
The List of Equations will only be printed if number register \fBLe\fP
 
403
is 1, default 0.
 
404
The string \fBLiec\fP contains the word \fIEquation\fP, wich
 
405
is printed before the number.
 
406
If \fIrefname\fP is used, then the equation number is saved with
 
407
\&\fB.SETR\fP, and can be retrieved with \fB.GETST\fP \fIrefname\fP.
 
408
.br
 
409
Special handling of the title will occur if
 
410
\fBEC\fP is used inside \fBDS\fP/\fBDE\fP, it will not be
 
411
affected by the format of \fBDS\fP.
 
412
.TP
 
413
.B "EF [arg]"
 
414
Even-page footer, printed just above the normal page footer
 
415
on even pages, see \fBPF\fP.
 
416
.TP
 
417
.B "EH [arg]"
 
418
Even-page header, printed just below the normal page header
 
419
on even pages, see \fBPH\fP.
 
420
.TP
 
421
.B EN
 
422
Equation end, see \fBEQ\fP.
 
423
.TP
 
424
.B EOP
 
425
End of page user-defined macro. This macro will be called
 
426
instead of the normal printing of the footer. The macro
 
427
will be executed in a separate environment, without any
 
428
trap active. See \fBTP\fP.
 
429
.sp
 
430
\fBStrings available to EOP\fP
 
431
.in +.5i
 
432
.T2 EOPf
 
433
Argument from \fBPF\fP.
 
434
.T2 EOPef
 
435
Argument from \fBEF\fP.
 
436
.T2 EOPof
 
437
Argument from \fBOF\fP.
 
438
.in
 
439
.TP
 
440
.B "EPIC width height [name]"
 
441
\fBEPIC\fP draws a box with the given \fIwidth\fP and \fIheight\fP, it will
 
442
also print the text \fIname\fP or a default string if
 
443
\fIname\fP is not specified..
 
444
This is used to include external pictures, just give the size
 
445
of the picture.
 
446
See \fBPIC\fP
 
447
.TP
 
448
.B "EQ [label]"
 
449
Equation start.
 
450
\fBEQ\fP/\fBEN\fP are the delimiters for equations written for \fBeqn\fP.
 
451
\fBEQ\fP/\fBEN\fP must be inside a \fBDS\fP/\fBDE\fP-pair, except
 
452
when \fBEQ\fP is only used to set options in \fBeqn\fP.
 
453
The \fIlabel\fP will appear at the right margin of the equation, unless
 
454
number register \fBEq\fP is 1. Then the label will appear at the
 
455
left margin.
 
456
.TP
 
457
.B "EX [title [override [flag [refname]]]]"
 
458
Exhibit title, arguments are the same as for \fBEC\fP.
 
459
\fBEX\fP uses the number register \fBEx\fP as counter.
 
460
The string \fBLx\fP controls the title of the
 
461
List of Exhibits, default is \fILIST OF EXHIBITS\fP.
 
462
The List of Exhibits will only be printed if number register \fBLx\fP
 
463
is 1, default 1.
 
464
The string \fBLiex\fP contains the word \fIExhibit\fP, which
 
465
is printed before the number.
 
466
If \fIrefname\fP is used, then the exhibit number is saved with
 
467
\&\fB.SETR\fP, and can be retrieved with \fB.GETST\fP \fIrefname\fP.
 
468
.br
 
469
Special handling of the title will occur if
 
470
\fBEX\fP is used inside \fBDS\fP/\fBDE\fP, it will not be
 
471
affected by the format of \fBDS\fP.
 
472
.TP
 
473
.B "FC [closing]"
 
474
Prints \fIYours\ very\ truly,\fP as a formal closing of a letter or
 
475
memorandum. The argument replaces the defualt string.
 
476
The default is stored in string variable \fBLetfc\fP.
 
477
.TP
 
478
.B "FD [arg [1]]"
 
479
Footnote default format.
 
480
Controls the hyphenation (hyphen), right margin justification (adjust),
 
481
indentation of footnote text (indent). It can also change the label
 
482
justification (ljust).
 
483
.sp
 
484
.ne 14v
 
485
.nf
 
486
.ta .5i +.8i +.8i +.8i +.8i
 
487
\fBarg  hyphen  adjust  indent  ljust\fP
 
488
0       no      yes     yes     left
 
489
1       yes     yes     yes     left
 
490
2       no      no      yes     left
 
491
3       yes     no      yes     left
 
492
4       no      yes     no      left
 
493
5       yes     yes     no      left
 
494
6       no      no      no      left
 
495
7       yes     no      no      left
 
496
8       no      yes     yes     right
 
497
9       yes     yes     yes     right
 
498
10      no      no      yes     right
 
499
11      yes     no      yes     right
 
500
.sp
 
501
.fi
 
502
.DT
 
503
Argument greater than or equal to 11 is considered as arg 0.
 
504
Default for m@TMAC_M_PREFIX@m is 10.
 
505
.TP
 
506
.B FE
 
507
Footnote end.
 
508
.TP
 
509
.B "FG [title [override [flag [refname]]]]"
 
510
Figure title, arguments are the same as for \fBEC\fP.
 
511
\fBFG\fP uses the number register \fBFg\fP as counter.
 
512
The string \fBLf\fP controls the title of the
 
513
List of Figures, default is \fILIST OF FIGURES\fP.
 
514
The List of Figures will only be printed if number register \fBLf\fP
 
515
is 1, default 1.
 
516
The string \fBLifg\fP contains the word \fIFigure\fP, wich
 
517
is printed before the number.
 
518
If \fIrefname\fP is used, then the figure number is saved with
 
519
\&\fB.SETR\fP, and can be retrieved with \fB.GETST\fP \fIrefname\fP.
 
520
.br
 
521
Special handling of the title will occur if
 
522
\fBFG\fP is used inside \fBDS\fP/\fBDE\fP, it will not be
 
523
affected by the format of \fBDS\fP.
 
524
.TP
 
525
.B "FS [label]"
 
526
Footnote start.
 
527
The footnote is ended by \fBFE\fP. Footnotes is normally automatically
 
528
numbered, the number is available in string \fBF\fP.
 
529
Just add \fB\e*F\fP in the text. By adding \fIlabel\fP, it is possible
 
530
to have other number or names on the footnotes.
 
531
Footnotes in displays is now possible.
 
532
An empty line separates footnotes, the height of the line
 
533
is controlled by number register \fBFs\fP, default value is 1.
 
534
.TP
 
535
.B "GETHN refname [varname]"
 
536
Includes the headernumber where the corresponding \fBSETR\fP \fIrefname\fP
 
537
was placed. Will be X.X.X. in pass 1. See \fBINITR\fP.
 
538
If \fIvarname\fP is used, \fBGETHN\fP sets the stringvariable \fIvarname\fP to the 
 
539
headernumber.
 
540
.TP
 
541
.B "GETPN refname [varname]"
 
542
Includes the pagenumber where the corresponding \fBSETR\fP \fIrefname\fP
 
543
was placed. Will be 9999 in pass 1. See \fBINITR\fP.
 
544
If \fIvarname\fP is used, \fBGETPN\fP sets the stringvariable \fIvarname\fP
 
545
to the pagenumber.
 
546
.TP
 
547
.B "GETR refname"
 
548
Combines \fBGETHN\fP and \fBGETPN\fP with the text 'chapter' and ', page'.
 
549
The string \fIQrf\fP contains the text for reference:
 
550
.ti +.5i
 
551
\&.ds Qrf See chapter \e\e*[Qrfh], page \e\e*[Qrfp].
 
552
.br
 
553
\fIQrf\fP may be changed to support other languages.
 
554
Strings \fIQrfh\fP and \fIQrfp\fP are set by \fBGETR\fP
 
555
and contains the page and headernumber.
 
556
.TP
 
557
.B "GETST refname [varname]"
 
558
Includes the string saved with the second argument to \fB.SETR\fP.
 
559
Will be dummystring in pass 1.
 
560
If varname is used, \fBGETST\fP sets the stringvariable \fIvarname\fP to the 
 
561
saved string. See \fBINITR\fP.
 
562
.TP
 
563
.B "H level [heading-text [heading-suffix]]"
 
564
Numbered section heading.
 
565
Section headers can have a level between 1 and 7, level 1 is the
 
566
top level. The text is given in \fIheading-text\fP, and must be
 
567
surrounded by double quotes if it contains spaces.
 
568
\fBHeading-suffix\fP is added to the header in the text but not in
 
569
the table of contents. This is normally used for footnote marks
 
570
and similar things. Don't use \fB\e*F\fP in \fIheading-suffix\fP, it won't
 
571
work. A manual label must be used, see \fBFS\fP.
 
572
.sp
 
573
An eventual paragraph, \fBP\fP, directly after \fBH\fP will be
 
574
ignored, \fBH\fP is taking care of spacing and indentation.
 
575
.sp
 
576
\fBPage ejection before heading\fP
 
577
.br
 
578
Number register \fBEj\fP controls page ejection before the heading.
 
579
Normally, a level one heading gets two blank lines before it, higher levels
 
580
gets only one. A new page is ejected before each
 
581
first-level heading if number register \fBEj\fP is 1.
 
582
All levels below or equal the value of \fBEj\fP gets a new page.
 
583
Default value for \fBEj\fP is 0.
 
584
.sp
 
585
\fBHeading break level\fP
 
586
.br
 
587
A line break occurs after the heading if the heading level is less
 
588
or equal to number register \fBHb\fP.
 
589
Default value 2.
 
590
.sp
 
591
\fBHeading space level\fP
 
592
.br
 
593
A blank line is inserted after the heading if the heading level is less
 
594
or equal to number register \fBHs\fP.
 
595
Default value 2.
 
596
.sp
 
597
Text will follow the heading on the same line if the level is greater
 
598
than both \fBHb\fP and \fBHs\fP.
 
599
.sp
 
600
\fBPost-heading indent\fP
 
601
.br
 
602
Indentation of the text after the heading is controlled by number
 
603
register \fBHi\fP, default value 0.
 
604
.sp
 
605
\fBHi\fP
 
606
.in +.5i
 
607
.T2 0
 
608
The text will be left-justified.
 
609
.T2 1
 
610
Indentation of the text will follow the value of number register \fBPt\fP,
 
611
see \fBP\fP.
 
612
.T2 2
 
613
The text will be lined up with the first word of the heading.
 
614
.in
 
615
.sp
 
616
\fBCentered section headings\fP
 
617
.br
 
618
All headings whose level is equal or below number register \fBHc\fP
 
619
and also less than or equal to \fBHb\fP or \fBHs\fP
 
620
is centerered.
 
621
.sp
 
622
\fBFont control of the heading\fP
 
623
.br
 
624
The font of each heading level is controlled by string \fBHF\fP.
 
625
It contains a fontnumber or fontname for each level. Default
 
626
is \fB2\ 2\ 2\ 2\ 2\ 2\ 2\fP (all headings in italic).
 
627
Could also be written as \fBI\ I\ I\ I\ I\ I\ I\fP.
 
628
All omitted values are presumed to be a 1.
 
629
.sp
 
630
\fBPoint size control\fP.
 
631
.br
 
632
String \fBHP\fP controls the pointsize of each heading, in the
 
633
same way as \fBHF\fP controls the font.
 
634
A value of 0 selects the default point size.
 
635
Default value is \fB0\ 0\ 0\ 0\ 0\ 0\ 0\fP. Beware that only the
 
636
point size changes, not the vertical size.
 
637
That can be controlled by the user specified macro \fBHX\fP and/or
 
638
\fBHZ\fP.
 
639
.sp
 
640
\fBHeading counters\fP
 
641
.br
 
642
Seven number registers, named \fBH1\fP thru \fBH7\fP contains
 
643
the counter for each heading level.
 
644
The values are printed using arabic numerals, this can be changed
 
645
with the macro \fBHM\fP (see below).
 
646
All marks are concatenated before printing. To avoid this, set
 
647
number register \fBHt\fP to 1. That will only print the current
 
648
heading counter at each heading.
 
649
.sp
 
650
\fBAutomatic table of contents\fP
 
651
.br
 
652
All headings whose level is equal or below number register \fBCl\fP
 
653
is saved to be printed in the table of contents. Default value is 2.
 
654
.sp
 
655
\fBSpecial control of the heading, user-defined macros\fP.
 
656
.br
 
657
These macros can be defined by the user to get a finer control
 
658
of vertical spacing, fonts or other features.
 
659
Argument \fIlevel\fP is the level-argument to \fBH\fP, but
 
660
0 for unnumbered headings (see \fBHU\fP).
 
661
Argument \fIrlevel\fP is the real level, it is
 
662
set to number register \fBHu\fP for unnumbered headings.
 
663
Argument \fIheading-text\fP is the text argument to \fBH\fP and \fBHU\fP.
 
664
.sp
 
665
\fBHX\ \fP\fIlevel\ rlevel\ heading-text\fP
 
666
.br
 
667
\fBHX\fP is called just before the printing of the heading.
 
668
The following register is available for \fBHX\fP.
 
669
\fBHX\fP may alter \fB}0\fP, \fB}2\fP and \fB;3\fP.
 
670
.in +.5i
 
671
.T3 "string }0"
 
672
Contains the heading mark plus two spaces if \fIrlevel\fP is non-zero,
 
673
otherwise empty.
 
674
.T3 "register ;0"
 
675
Contains the position of the text after the heading.
 
676
0 means that the text should follow the heading on the same line, 1
 
677
means that a line break should occur before the text and
 
678
2 means that a blank line should separate the heading and the text.
 
679
.T3 "string }2"
 
680
Contains two spaces if register \fB;0\fP is 0. It is used to
 
681
separate the heading from the text. The string
 
682
is empty if \fB;0\fP is non-zero.
 
683
.T3 "register ;3"
 
684
Contains the needed space in units after the heading.
 
685
Default is 2v.
 
686
 
 
687
Can be used to change things like numbering (\fB}0\fP),
 
688
vertical spacing (\fB}2\fP)
 
689
and the needed space after the heading.
 
690
.in
 
691
.sp
 
692
\fBHY\ \fP\fIdlevel\ rlevel\ heading-text\fP
 
693
.br
 
694
\fBHY\fP is called after size and font calculations and
 
695
might be used to change indentation.
 
696
.sp
 
697
\fBHZ\ \fP\fIdlevel\ rlevel\ heading-text\fP
 
698
.br
 
699
\fBHZ\fP is called after the printing of the heading, just before
 
700
\fBH\fP or \fBHU\fP exits.
 
701
Could be used to change the page header according to the section heading.
 
702
.TP
 
703
.B "HC [hyphenation-character]"
 
704
Set hyphenation character.
 
705
Default value is \e%.
 
706
Resets to the default if called without argument.
 
707
Hyphenation can be turned off by setting number
 
708
register \fBHy\fP to 0 in the beginning of the file.
 
709
.TP
 
710
.B "HM [arg1 [arg2 [... [arg7]]]]"
 
711
Heading mark style. 
 
712
Controls the type of marking for printing of the heading counters.
 
713
Default is 1 for all levels.
 
714
.sp
 
715
\fBArgument\fP
 
716
.in +.5i
 
717
.T2 1
 
718
Arabic numerals.
 
719
.T2 0001
 
720
Arabic numerals with leading zeroes, one or more.
 
721
.T2 A
 
722
Upper-case alphabetic
 
723
.T2 a
 
724
Lower-case alphabetic
 
725
.T2 I
 
726
Upper-case roman numerals
 
727
.T2 i
 
728
lower-case roman numerals
 
729
.T2 \fIempty\fP
 
730
Arabic numerals.
 
731
.in
 
732
.TP
 
733
.B "HU heading-text"
 
734
Unnumbered section header.
 
735
\fBHU\fP behavies like \fBH\fP at the level in number register \fBHu\fP.
 
736
See \fBH\fP.
 
737
.TP
 
738
.B "HX dlevel rlevel heading-text"
 
739
Userdefined heading exit.
 
740
Called just before printing the header.
 
741
See \fBH\fP.
 
742
.TP
 
743
.B "HY dlevel rlevel heading-text"
 
744
Userdefined heading exit.
 
745
Called just before printing the header.
 
746
See \fBH\fP.
 
747
.TP
 
748
.B "HZ dlevel rlevel heading-text"
 
749
Userdefined heading exit.
 
750
Called just after printing the header.
 
751
See \fBH\fP.
 
752
.TP
 
753
.B "I [italic-text [prev-font-text [italic-text [...]]]]"
 
754
Italic.
 
755
Changes the font to italic if called without arguments.
 
756
With one argument it will set the word in italic.
 
757
With two argument it will concatenate them and set the first
 
758
word in italic and the second in the previous font.
 
759
There is no limit on the number of argument, all will be concatenated.
 
760
.TP
 
761
.B "IA [addressee-name [title]]"
 
762
Begins specification of the addressee and addressee's address in
 
763
letter style.
 
764
Several names can be specified with empty \fBIA\fP/\fBIE\fP-pairs, but
 
765
only one address.
 
766
See \fBLT\fP.
 
767
.TP
 
768
.B "IB [italic-text [bold-text [italic-text [...]]]]"
 
769
Italic-bold.
 
770
Even arguments is printed in italic, odd in boldface.
 
771
See \fBI\fP.
 
772
.TP
 
773
.B IE
 
774
Ends the address-specification after \fPIA\fP.
 
775
.TP
 
776
.B "INITI type filename [macro]"
 
777
Initialize the new index system, sets the filename to collect
 
778
index lines in with \fBIND\fP. Argument \fItype\fP selects
 
779
the type of index, page number, header marks or both.
 
780
The default is \fIN\fP.
 
781
 
 
782
It is also possible to create a macro that is responsible
 
783
for formatting each row. Add the name of the macro as argument 3.
 
784
The macro will be called with the index as argument(s).
 
785
.sp
 
786
\fBtype\fP
 
787
.in +.5i
 
788
.T2 N
 
789
Page numbers
 
790
.T2 H
 
791
Header marks
 
792
.T2 B
 
793
Both page numbers and header marks, tab separated
 
794
.in
 
795
.TP
 
796
.B "INITR filename"
 
797
Initialize the refencemacros. References will be written to
 
798
\fIfilename.tmp\fP and \fIfilename.qrf\fP. Requires two passes with groff.
 
799
The first looks for references and the second includes them.
 
800
\fBINITR\fP can be used several times, but it is only the first
 
801
occurrence of \fBINITR\fP that is active.
 
802
Option \fB-U\fP might be needed if \fBunsafe\fP-errors occur.
 
803
See also \fBSETR\fP, \fBGETPN\fP and \fBGETHN\fP.
 
804
.TP
 
805
.B "IND arg1 [arg2 [...]]"
 
806
\fBIND\fP writes a line in the index file selected by \fBINITI\fP
 
807
with all arguments and the page number or header mark separated by tabs.
 
808
.in +.5i
 
809
\fBExamples\fP
 
810
.br
 
811
arg1\etpage number
 
812
.br
 
813
arg1\etarg2\etpage number
 
814
.br
 
815
arg1\etheader mark
 
816
.br
 
817
arg1\etpage number\etheader mark
 
818
.in
 
819
.TP
 
820
.B "INDP"
 
821
\fBINDP\fP prints the index by running the command specified
 
822
by string variable \fBIndcmd\fP, normally \fIsort\ -t\et\fP.
 
823
\fBINDP\fP reads the output from the command to form
 
824
the index, normally in two columns (can be changed by defining \fBTYIND\fP).
 
825
The index is printed with string variable \fBIndex\fP as header,
 
826
default is \fBINDEX\fP. One-column processing is
 
827
returned after the list. \fBINDP\fP will call the
 
828
user-defined macros \fBTXIND\fP, \fBTYIND\fP and \fBTZIND\fP if defined.
 
829
\fBTXIND\fP is called before printing \fBINDEX\fP, \fBTYIND\fP
 
830
is called instead of printing \fBINDEX\fP. \fBTZIND\fP is called
 
831
after the printing and should take care of restoring to normal
 
832
operation again.
 
833
.TP
 
834
.B "ISODATE [0]"
 
835
\fBISODATE\fP changes the predefined date string in \fBDT\fP to
 
836
ISO-format, ie YYYY-MM-DD. This can also be done by
 
837
adding \fB-rIso=1\fP on the command line.
 
838
Reverts to old date format if argument is \fB0\fP.
 
839
.TP
 
840
.B "IR [italic-text [roman-text [italic-text [...]]]]"
 
841
Italic-roman.
 
842
Even arguments is printed in italic, odd in roman.
 
843
See \fBI\fP.
 
844
.TP
 
845
.B "LB text-indent mark-indent pad type [mark [LI-space [LB-space]]]"
 
846
List begin macro.
 
847
This is the common macro used for all lists.
 
848
\fIText-indent\fP is the number of spaces to indent the text from the
 
849
current indent.
 
850
.sp
 
851
\fIPad\fP and \fImark-indent\fP controls where to put the mark.
 
852
The mark is placed within the mark area, and \fImark-indent\fP
 
853
sets the number of spaces before this area. It is normally 0.
 
854
The mark area ends where the text begins. The start of the text
 
855
is still controlled by \fItext-indent\fP.
 
856
.sp
 
857
The mark is left justified whitin the mark area if \fIpad\fP is 0.
 
858
If \fIpad\fP is greater than 0, then \fImark-indent\fP is ignored, and
 
859
the mark is placed \fIpad\fP spaces before the text.
 
860
This will right justify the mark.
 
861
.sp
 
862
If \fItype\fP is 0 the list will have either a hanging indent or, if
 
863
argument \fImark\fP is given, the string \fImark\fP as mark.
 
864
.sp
 
865
If \fItype\fP is greater than 0 automatic numbering will occur, arabic
 
866
if \fImark\fP is empty. \fIMark\fP can then be any of \fB1\fP, \fBA\fP,
 
867
\fBa\fP, \fBI\fP or \fBi\fP.
 
868
.sp
 
869
\fIType\fP selects one of six possible ways to display the mark.
 
870
.br
 
871
\fBtype\fP
 
872
.in +.6i
 
873
.T2 1
 
874
x.
 
875
.T2 2
 
876
x)
 
877
.T2 3
 
878
(x)
 
879
.T2 4
 
880
[x]
 
881
.T2 5
 
882
<x>
 
883
.T2 6
 
884
{x}
 
885
.in
 
886
.sp
 
887
Every item in the list will get \fILI-space\fP number of blank lines
 
888
before them. Default is 1. 
 
889
.sp
 
890
\fBLB\fP itself will print \fILB-space\fP blank lines. Default is 0.
 
891
.TP
 
892
.B "LC [list-level]"
 
893
List-status clear.
 
894
Terminates all current active lists down to \fIlist-level\fP, or 0
 
895
if no argmuent is given. This is used by \fBH\fP to clear any
 
896
active list.
 
897
.TP
 
898
.B "LE [1]"
 
899
List end.
 
900
Terminate the current list. \fBLE\fP outputs a blank line
 
901
if an argument is given.
 
902
.TP
 
903
.B "LI [mark [1]]"
 
904
List item precedes every item in a list. Without argument \fBLI\fP
 
905
will print the mark determined by the current list type. By giving
 
906
\fBLI\fP one argument, it will use that as the mark instead.
 
907
Two arguments to \fBLI\fP will make \fImark\fP a prefix to
 
908
the current mark.
 
909
There will be no separating space between the prefix
 
910
and the mark if the second argument is \fB2\fP instead of \fB1\fP.
 
911
This behaviour can also be achieved by setting number register
 
912
\fBLimsp\fP to zero.
 
913
A zero length \fImark\fP will make a hanging
 
914
indent instead.
 
915
.sp
 
916
A blank line is normally printed before the list item. This behaviour
 
917
can be controlled by number register \fBLs\fP. Pre-spacing
 
918
will occur for each list-level less than or equal to \fBLs\fP.
 
919
Default value is 99. (Nesting of lists is unlimited. :-)
 
920
.sp
 
921
The indentation can be changed thru number register \fBLi\fP.
 
922
Default is 6.
 
923
.sp
 
924
All lists begins with a list initialization macro, \fBLB\fP.
 
925
There are, however, seven predefined listtypes to
 
926
make lists easier to use. They all call \fBLB\fP with different
 
927
default values.
 
928
.in +.5i
 
929
.T2 \fBAL\fP
 
930
Automatically Incremented List
 
931
.T2 \fBML\fP
 
932
Marked List
 
933
.T2 \fBVL\fP
 
934
Variable-Item List
 
935
.T2 \fBBL\fP
 
936
Bullet List
 
937
.T2 \fBDL\fP
 
938
Dash List
 
939
.T2 \fBRL\fP
 
940
Reference List
 
941
.T2 \fBBVL\fP
 
942
Broken Varable List.
 
943
.in
 
944
These lists are described at other places in this manual. See also \fBLB\fP.
 
945
.TP
 
946
.B "LT [arg]"
 
947
Formats a letter in one of four different styles depending
 
948
on the argument.
 
949
See also \fBINTERNALS\fP.
 
950
.in +.5i
 
951
.T2 \fBArg
 
952
Style\fP
 
953
.T2 BL
 
954
Blocked. Date line, return address, writer's address and closing
 
955
begins at the center of the line. All other lines begin at the left margin.
 
956
.T2 SB
 
957
Semi-blocked. Same as blocked, except that the first line in every
 
958
paragraph is indented five spaces.
 
959
.T2 FB
 
960
Full-blocked. All lines begin at the left margin.
 
961
.T2 SP
 
962
Simplified. Almost the same as the full-blocked style. Subject and
 
963
the writer's identification are printed in all-capital.
 
964
.in
 
965
.TP
 
966
.B "LO type [arg]"
 
967
Specify options in letter (see \fB.LT\fP).
 
968
This is a list of the standard options:
 
969
.in +.5i
 
970
.T2 CN
 
971
Confidential notation. Prints \fBCONFIDENTIAL\fP on the second line
 
972
below the date line. Any argument replaces \fBCONFIDENTIAL\fP.
 
973
See also string variable \fBLetCN\fP.
 
974
.T2 RN
 
975
Reference notation. Prints \fBIn reference to:\fP and the argument
 
976
two lines below the date line.
 
977
See also string variable \fBLetRN\fP.
 
978
.T2 AT
 
979
Attention. Prints \fBATTENTION:\fP and the argument below the inside address.
 
980
See also string variable \fBLetAT\fP.
 
981
.T2 SA
 
982
Salutation. Prints \fBTo Whom It May Concern:\fP or the argument if
 
983
it was present. The salutation is printed two lines below the inside address.
 
984
See also string variable \fBLetSA\fP.
 
985
.T2 SJ
 
986
Subject line. Prints the argument as subject prefixed with \fBSUBJECT:\fP
 
987
two lines below the inside address, except in letter type \fBSP\fP.
 
988
Then the subject is printed in all-captial without any prefix.
 
989
See also string variable \fBLetSJ\fP.
 
990
.in
 
991
.TP
 
992
.B "MC column-size [column-separation] "
 
993
Begin multiple columns. Return to normal with \fB1C\fP.
 
994
\fBMC\fP will create as many columns as the current line length permits.
 
995
\fIColumn-size\fP is the width of each column, and \fIcolumn-separation\fP
 
996
is the space between two columns. Default separation is the 
 
997
column-size/15.
 
998
See also \fB1C\fP.
 
999
.TP
 
1000
.B "ML mark [text-indent [1]]"
 
1001
Marked list start. The \fImark\fP argument will be printed before
 
1002
each list item.
 
1003
\fIText-indent\fP sets the indent and overrides \fBLi\fP.
 
1004
A third argument will prohibit printing of a blank line before each
 
1005
item.
 
1006
.TP
 
1007
.B "MT [arg [addressee]]"
 
1008
Memorandum type.
 
1009
The \fIarg\fP is part of a filename in \fI@TMAC_MDIR@/*.MT\fP.
 
1010
Memorandum type 0 thru 5 are supported, including \fI"string"\fP.
 
1011
\fIAddressee\fP just sets a variable, used in the AT&T macros.
 
1012
.br
 
1013
\fBarg\fP
 
1014
.in +.5i
 
1015
.T2 0
 
1016
Normal memorandum, no type printed
 
1017
.T2 1
 
1018
Memorandum with \fIMEMORANDUM FOR FILE\fP printed
 
1019
.T2 2
 
1020
Memorandum with \fIPROGRAMMER'S NOTES\fP printed
 
1021
.T2 3
 
1022
Memorandum with \fIENGINEER'S NOTES\fP printed
 
1023
.T2 4
 
1024
Released paper style
 
1025
.T2 5
 
1026
External letter style
 
1027
.in
 
1028
See also \fBCOVER\fP/\fBCOVEND\fP, a more flexible type of front page.
 
1029
.TP
 
1030
.B "MOVE y-pos [x-pos [line-length]]"
 
1031
Move to a position, pageoffset set to \fIx-pos\fP.
 
1032
If \fIline-length\fP is not given, the difference between
 
1033
current and new pageoffset is used.
 
1034
Use \fBPGFORM\fP without arguments to return to normal.
 
1035
.TP
 
1036
.B "MULB cw1 space1 [cw2 space2 [cw3 ...]]"
 
1037
Begin a special multi-column mode. Every columns width must be specified.
 
1038
Also the space between the columns must be specified. The last column
 
1039
does not need any space-definition. \fBMULB\fP starts a diversion and \fBMULE\fP
 
1040
ends the diversion and prints the columns.
 
1041
The unit for width and space is 'n', but \fBMULB\fP accepts all 
 
1042
normal unitspecifications like 'c' and 'i'.
 
1043
\fBMULB\fP operates in a separate environment.
 
1044
.TP
 
1045
.B "MULN"
 
1046
Begin the next column. This is the only way to switch column.
 
1047
.TP
 
1048
.B "MULE"
 
1049
End the multi-column mode and print the columns.
 
1050
.TP
 
1051
.B "nP [type]"
 
1052
Print numbered paragraph with header level two. See \fB.P\fP.
 
1053
.TP
 
1054
.B "NCOL"
 
1055
Force printing to the next column, don't use this together with
 
1056
the \fBMUL*\fP macros, see \fB2C\fP.
 
1057
.TP
 
1058
.B "NS [arg [1]]"
 
1059
Prints different types of notations. The argument selects between
 
1060
the predefined type of notations. If the second argument is available, 
 
1061
then the argument becomes the entire notation.
 
1062
If the argument doesn't exist in the predefined, it will be
 
1063
printed as \fBCopy (\fP\fIarg\fP\fB) to\fP.
 
1064
It is possible to add more standard notations, see the string variable
 
1065
\fBLetns\fP and \fBLetnsdef\fP.
 
1066
.nf
 
1067
.in +.5i
 
1068
.T2 \fBArg
 
1069
Notation\fP
 
1070
.T2 \fInone\fP
 
1071
Copy To
 
1072
.T2 """""
 
1073
Copy To
 
1074
.T2 1
 
1075
Copy To (with att.) to
 
1076
.T2 2
 
1077
Copy To (without att.) to
 
1078
.T2 3
 
1079
Att.
 
1080
.T2 4
 
1081
Atts.
 
1082
.T2 5
 
1083
Enc.
 
1084
.T2 6
 
1085
Encs.
 
1086
.T2 7
 
1087
Under separate cover
 
1088
.T2 8
 
1089
Letter to
 
1090
.T2 9
 
1091
Memorandum to
 
1092
.T2 10
 
1093
Copy (with atts.) to
 
1094
.T2 11
 
1095
Copy (without atts.) to
 
1096
.T2 12
 
1097
Abstract Only to
 
1098
.T2 13
 
1099
Complete Memorandum to
 
1100
.T2 14
 
1101
CC
 
1102
.in
 
1103
.fi
 
1104
.TP
 
1105
.B "ND new-date"
 
1106
New date. Override the current date. Date is not
 
1107
printed if \fInew-date\fP is an empty string.
 
1108
.TP
 
1109
.B "OF [arg]"
 
1110
Odd-page footer, a line printed just above the normal footer.
 
1111
See \fBEF\fP and \fBPF\fP.
 
1112
.TP
 
1113
.B "OH [arg]"
 
1114
Odd-page header, a line printed just below the normal header.
 
1115
See \fBEH\fP and \fBPH\fP.
 
1116
.TP
 
1117
.B OP
 
1118
Make sure that the following text is printed at the top
 
1119
of an odd-numbered page. Will not output an empty page
 
1120
if currently at the top of an odd page.
 
1121
.TP
 
1122
.B "P [type]"
 
1123
Begin new paragraph.
 
1124
\fBP\fP without argument will produce left justified text, even
 
1125
the first line of the paragraph. This is the same as setting
 
1126
\fItype\fP to 0. If the argument is 1, then the first line
 
1127
of text following \fBP\fP will be indented by the number of
 
1128
spaces in number register \fBPi\fP, normally 5.
 
1129
.sp
 
1130
Instead of giving 1 as argument to \fBP\fP it is possible to set the
 
1131
paragraph type in number register \fBPt\fP. Using 0 and 1
 
1132
will be the same as adding that value to \fBP\fP.
 
1133
A value of 2 will indent all paragraphs, except after
 
1134
headings, lists and displays.
 
1135
.sp
 
1136
The space between two paragraphs is controlled by number register \fBPs\fP,
 
1137
and is 1 by default (one blank line).
 
1138
.TP
 
1139
.B "PGFORM [linelength [pagelength [pageoffset [1]]]]"
 
1140
Sets linelength, pagelength and/or pageoffset.
 
1141
This macro can be used for special formatting, like letterheads
 
1142
and other.
 
1143
It is normally the first command in a file, though it's not necessary.
 
1144
\fBPGFORM\fP can be used without arguments 
 
1145
to reset everything after a \fBMOVE\fP.
 
1146
A line-break is done unless the fourth argument is given. 
 
1147
This can be used to avoid the pagenumber on the first page while setting
 
1148
new width and length.
 
1149
(It seems as if this macro sometimes doesn't work too well.
 
1150
Use the command line arguments
 
1151
to change linelength, pagelength and pageoffset instead. Sorry.)
 
1152
.TP
 
1153
.B PGNH
 
1154
No header is printed on the next page. Used to get rid of
 
1155
the header in letters or other special texts.
 
1156
This macro must be used before any text to inhibit the pageheader
 
1157
on the first page.
 
1158
.TP
 
1159
.B PIC [-L] [-C] [-R] [-I n] filename [width [height]]
 
1160
\fBPIC\fP includes a Postscript file in the document.
 
1161
The macro depends on \fBmmroff\fP and \fBINITR\fP.
 
1162
\fB-L\fP, \fB-C\fP, \fB-R\fP and \fB-I n\fP adjusts the picture
 
1163
or indents it. The optionally \fIwidth\fP and \fIheight\fP
 
1164
can also be given to resize the picture.
 
1165
.TP
 
1166
.B PE
 
1167
Picture end.
 
1168
Ends a picture for \fB@TMAC_M_PREFIX@pic\fP, see the manual for \fB@TMAC_M_PREFIX@pic\fP.
 
1169
.TP
 
1170
.B "PF [arg]"
 
1171
Page footer.
 
1172
\fBPF\fP sets the line to be printed at the bottom of each page.
 
1173
Normally empty. See \fBPH\fP for the argument specification.
 
1174
.TP
 
1175
.B "PH [arg]"
 
1176
Page header, a line printed at the top of each page.
 
1177
The argument should be specified as "'left-part'center-part'right-part'",
 
1178
where left-, center- and right-part is printed left-justified, centered
 
1179
and right justified. The character \fB%\fP is changed to the current
 
1180
page number. The default page-header is "''- % -''", the page
 
1181
number between two dashes.
 
1182
.TP
 
1183
.B PS
 
1184
Picture start (from pic). Begins a picture for \fB@g@pic\fP, see
 
1185
the manual.
 
1186
.TP
 
1187
.B PX
 
1188
Page-header user-defined exit.
 
1189
\fBPX\fP is called just after the printing of the page header
 
1190
in \fIno-space\fP mode.
 
1191
.TP
 
1192
.B R
 
1193
Roman.
 
1194
Return to roman font, see also \fBI\fP.
 
1195
.TP
 
1196
.B "RB [roman-text [bold-text [roman-text [...]]]]"
 
1197
Roman-bold.
 
1198
Even arguments is printed in roman, odd in boldface.
 
1199
See \fBI\fP.
 
1200
.TP
 
1201
.B "RD [prompt [diversion [string]]]"
 
1202
Read from standard input to diversion and/or string.
 
1203
The text will be saved in a diversion named \fIdiversion\fP.
 
1204
Recall the text by writing the name of the diversion after a dot
 
1205
on an empty line. A string will also be defined if
 
1206
\fIstring\fP is given. \fIDiversion\fP and/or \fIprompt\fP can 
 
1207
be empty ("").
 
1208
.TP
 
1209
.B RF
 
1210
Reference end. Ends a reference definition and returns to normal
 
1211
processing. See \fBRS\fP.
 
1212
.TP
 
1213
.B "RI [roman-text [italic-text [roman-text [...]]]]"
 
1214
Even arguments are printed in roman, odd in italic.
 
1215
See \fBI\fP.
 
1216
.TP
 
1217
.B "RL [text-indent [1]]"
 
1218
Reference list start.
 
1219
Begins a list where each item is preceded with a automatically
 
1220
incremented number between
 
1221
square brackets.
 
1222
\fIText-indent\fP changes the default indentation.
 
1223
.TP
 
1224
.B "RP [arg1 [arg2]]"
 
1225
Produce reference page.
 
1226
\fBRP\fP can be used if a reference page is wanted somewhere in the
 
1227
document. It is not needed if \fBTC\fP is used to produce
 
1228
a table of content. The reference page will then be printed automatically.
 
1229
.sp
 
1230
The reference counter will not be reset if \fIarg1\fP is 1.
 
1231
.sp
 
1232
\fIArg2\fP tells \fBRP\fP whether to eject a page or not.
 
1233
.br
 
1234
\fBArg2\fP
 
1235
.in +.5i
 
1236
.T2 0
 
1237
The reference page will be printed on a separate page.
 
1238
This is
 
1239
the default.
 
1240
.T2 1
 
1241
Do not eject page after the list.
 
1242
.T2 2
 
1243
Do not eject page before the list.
 
1244
.T2 3
 
1245
Do not eject page before and after the list.
 
1246
.in
 
1247
The reference items will be separated by a blank line.
 
1248
Setting number register \fBLs\fP to 0 will suppress the line.
 
1249
.sp
 
1250
The string \fBRp\fP contains the reference page title and
 
1251
is normally set to \fIREFERENCES\fP.
 
1252
.TP
 
1253
.B "RS [string-name]"
 
1254
\fBRS\fP begins an automatically numbered reference definition.
 
1255
Put the string \fB\e*(Rf\fP where the reference mark
 
1256
should be and write the reference between \fBRS\fP/\fBRF\fP
 
1257
at next new line after the reference mark. The reference number
 
1258
is stored in number register \fB:R\fP.
 
1259
If \fIstring-name\fP is given, a string with that name
 
1260
will be defined and contain the current reference mark.
 
1261
The string can be referenced as \fB\e*[\fIstring-name\fP]\fP later in
 
1262
the text.
 
1263
.TP
 
1264
.B "S [size [spacing]]"
 
1265
Set point size and vertical spacing. If any argument is equal 'P', then
 
1266
the previous value is used. A 'C' means current value, and 'D' default value.
 
1267
If '+' or '-' is used before the value, then increment or decrement of
 
1268
the current value will be done.
 
1269
.TP
 
1270
.B "SA [arg]"
 
1271
Set right-margin justification.
 
1272
Justification is normally turned on.
 
1273
No argumenent or \fB0\fP turns off justification, a \fB1\fP turns on
 
1274
justification.
 
1275
.TP
 
1276
.B "SETR refname [string]"
 
1277
Remember the current header and page-number as \fIrefname\fP.
 
1278
Saves \fIstring\fP if \fIstring\fP is defined. \fIstring\fP is retrieved
 
1279
with \fB.GETST\fP.
 
1280
See \fBINITR\fP.
 
1281
.TP
 
1282
.B "SG [arg [1]]"
 
1283
Signature line. Prints the authors name(s) after the formal closing.
 
1284
The argument will be appended to the reference data, printed
 
1285
at either the first or last author. The reference data is the location,
 
1286
department and initials specified with \fB.AU\fP.
 
1287
It will be printed at the first author if the second argument is given,
 
1288
otherwise at the last.
 
1289
No reference data will be printed if the author(s) is specifed
 
1290
thru \fB.WA\fP/\fB.WE\fP.
 
1291
See \fBINTERNALS\fP.
 
1292
.TP
 
1293
.B "SK [pages]"
 
1294
Skip pages.
 
1295
If \fIpages\fP is \fB0\fP or omitted, a skip to the next page
 
1296
will occur unless it is already at the top of a page.
 
1297
Otherwise it will skip \fIpages\fP pages.
 
1298
.TP
 
1299
.B "SM string1 [string2 [string3]]"
 
1300
Make a string smaller.
 
1301
If \fIstring2\fP is given, \fIstring1\fP will be smaller and \fIstring2\fP
 
1302
normal, concatenated with \fIstring1\fP. With three argument, all is
 
1303
concatenated, but only \fIstring2\fP is made smaller.
 
1304
.TP
 
1305
.B "SP [lines]"
 
1306
Space vertically. \fIlines\fP can have any scalingfactor, like \fI3i\fP or
 
1307
\fI8v\fP. Several \fBSP\fP in a line will only produce the
 
1308
maximum number of lines, not the sum. \fBSP\fP will also be ignored
 
1309
until the first textline in a page. Add a \fB\e&\fP before \fBSP\fP
 
1310
to avoid this.
 
1311
.TP
 
1312
.B TAB
 
1313
reset tabs to every 5n. Normally used to reset any previous tabpositions.
 
1314
.TP
 
1315
.B "TB [title [override [flag [refname]]]]"
 
1316
Table title, arguments are the same as for \fBEC\fP.
 
1317
\fBTB\fP uses the number register \fBTb\fP as counter.
 
1318
The string \fBLt\fP controls the title of the
 
1319
List of Tables, default is \fILIST OF TABLES\fP.
 
1320
The List of Tables will only be printed if number register \fBLt\fP
 
1321
is 1, default 1.
 
1322
The string \fBLitb\fP contains the word \fITABLE\fP, wich
 
1323
is printed before the number.
 
1324
.br
 
1325
Special handling of the title will occur if
 
1326
\fBTB\fP is used inside \fBDS\fP/\fBDE\fP, it will not be
 
1327
affected by the format of \fBDS\fP.
 
1328
.TP
 
1329
.B "TC [slevel [spacing [tlevel [tab [h1 [h2 [h3 [h4 [h5]]]]]]]]]"
 
1330
Table of contents.
 
1331
This macro is normally used at the last line of the document.
 
1332
It generates a table of contents with headings up to the level
 
1333
controlled by number register \fBCl\fP. Note that \fBCl\fP controls
 
1334
the saving of headings, it has nothing to do with \fBTC\fP.
 
1335
Headings with level less than or equal to \fIslevel\fP will get
 
1336
\fIspacing\fP number of lines before them.
 
1337
Headings with level less than or equal to \fItlevel\fP will have
 
1338
their page numbers right justified with dots or spaces separating
 
1339
the text and the page number. Spaces is used if \fItab\fP
 
1340
is greater than zero, otherwise dots.
 
1341
Other headings will have the
 
1342
page number directly at the end of the heading text (\fIragged right\fP).
 
1343
.sp
 
1344
The rest of the arguments will be printed, centered, before the
 
1345
table of contents.
 
1346
.sp
 
1347
The user-defined macros \fBTX\fP and \fBTY\fP are used if \fBTC\fP is called
 
1348
with at most four arguments. \fBTX\fP is called before the printing
 
1349
of \fICONTENTS\fP, and \fBTY\fP is called instead of printing \fICONTENTS\fP.
 
1350
.sp
 
1351
Equivalent macros can be defined for list of figures, tables, equations
 
1352
and excibits by defining \fBTXxx\fP or \fBTYxx\fP, where \fBxx\fP
 
1353
is \fBFg\fP, \fBTB\fP, \fBEC\fP or \fBEX\fP.
 
1354
.sp
 
1355
String \fBCi\fP can be set to control the indentations for each heading-level.
 
1356
It must be scaled, like \fB.ds\ Ci\ .25i\ .5i\ .75i\ 1i\ 1i\fP.
 
1357
The indentation is normally controlled by the maxlength of headings
 
1358
in each level.
 
1359
.sp
 
1360
All texts can be redefined, new stringvariables 
 
1361
\fILifg\fP, \fILitb\fP, \fILiex\fP, \fILiec\fP and \fILicon\fP contain
 
1362
"Figure", "TABLE", "Exhibit", "Equation" and "CONTENTS".
 
1363
These can be redefined to other languages.
 
1364
.TP
 
1365
.B TE
 
1366
Table end. See \fBTS\fP.
 
1367
.TP
 
1368
.B "TH [N]"
 
1369
Table header. See \fBTS\fP.
 
1370
\fBTH\fP ends the header of the table. This header will
 
1371
be printed again if a page-break occurs.
 
1372
Argument \fIN\fP isn't implemented yet.
 
1373
.TP
 
1374
.B TL [charging-case number(s) [filing-case number(s)]]
 
1375
Begin title of memorandum.
 
1376
All text up to the next \fBAU\fP is included in the title.
 
1377
\fICharging-case number\fP and \fIfiling-case\fP are saved
 
1378
for use in the front page processing.
 
1379
.TP
 
1380
.B TM [num1 [num2 [...]]]
 
1381
Technical memorandumnumbers used in \fB.MT\fP. Unlimited number
 
1382
of arguments may be given.
 
1383
.TP
 
1384
.B TP
 
1385
Top of page user-defined macro.
 
1386
This macro is called instead of the normal page header. It is
 
1387
possible to get complete control over the header.
 
1388
Note that header and footer is printed in a separate environment.
 
1389
Linelength is preserved though.
 
1390
.TP
 
1391
.B "TS [H]"
 
1392
Table start. This is the start of a table specification
 
1393
to \fB@g@tbl\fP. See separate manual for \fB@g@tbl\fP.
 
1394
\fBTS\fP ends with \fBTE\fP.
 
1395
Argument \fIH\fP tells \fBm@TMAC_M_PREFIX@m\fP that the table
 
1396
has a header. See \fBTH\fP.
 
1397
.TP
 
1398
.B TX
 
1399
Userdefined table of contents exit.
 
1400
This macro is called just before \fBTC\fP prints the word \fICONTENTS\fP.
 
1401
See \fBTC\fP.
 
1402
.TP
 
1403
.B TY
 
1404
Userdefined table of contents exit (no "CONTENTS").
 
1405
This macro is called instead of printing \fICONTENTS\fP.
 
1406
See \fBTC\fP.
 
1407
.TP
 
1408
.B VERBON [flag [pointsize [font]]]
 
1409
Begin verbatim output using courier font.
 
1410
Usually for printing programs.
 
1411
All character has equal width.
 
1412
The pointsize can be changed with
 
1413
the second argument. By specifying the font-argument
 
1414
it is possible to use another font instead of courier.
 
1415
\fIflag\fP controls several special features.
 
1416
It contains the sum of all wanted features.
 
1417
.in +.5i
 
1418
.T2 Value
 
1419
Description
 
1420
.T2 1
 
1421
Disable the escape-character (\e). This is normally turned on during
 
1422
verbose output.
 
1423
.T2 2
 
1424
Add an empty line before the verbose text.
 
1425
.T2 4
 
1426
Add an empty line after the verbose text.
 
1427
.T2 8
 
1428
Print the verbose text with numbered lines. This adds four digitsized
 
1429
spaces in the beginning of each line. Finer control is available with
 
1430
the string-variable \fBVerbnm\fP. It contains all arguments to the
 
1431
\fBtroff\fP-command \fB.nm\fP, normally '1'.
 
1432
.T2 16
 
1433
Indent the verbose text with five 'n':s. This is controlled by the
 
1434
number-variable \fBVerbin\fP (in units).
 
1435
.in
 
1436
.TP
 
1437
.B VERBOFF
 
1438
End verbatim output.
 
1439
.TP
 
1440
.B "VL text-indent [mark-indent [1]]"
 
1441
Variable-item list has no fixed mark, it assumes that
 
1442
every \fBLI\fP have a mark instead.
 
1443
\fIText-indent\fP sets the indent to the text, and \fImark-indent\fP
 
1444
the distance from the current indent to the mark.
 
1445
A third argument will prohibit printing of a blank line before each
 
1446
item.
 
1447
.TP
 
1448
.B "VM [top [bottom]]"
 
1449
Vertical margin.
 
1450
.TP
 
1451
.B "WA [writer-name [title]]"
 
1452
Begins specification of the writer and writer's address.
 
1453
Several names can be specified with empty \fBWA\fP/\fBWE\fP-pairs, but
 
1454
only one address.
 
1455
.TP
 
1456
.B WE
 
1457
Ends the address-specification after \fP.WA\fP.
 
1458
.TP
 
1459
.B "WC [format]"
 
1460
Footnote and display width control.
 
1461
.in +.5i
 
1462
.T2 N
 
1463
Set default mode, \fB-WF\fP, \fB-FF\fP, \fB-WD\fP and \fBFB\fP.
 
1464
.T2 WF
 
1465
Wide footnotes, wide also in two-column mode.
 
1466
.T2 -WF
 
1467
Normal footnote width, follow column mode.
 
1468
.T2 FF
 
1469
All footnotes gets the same width as the first footnote encountered.
 
1470
.T2 -FF
 
1471
Normal footnotes, width follows \fBWF\fP and \fB-WF\fP.
 
1472
.T2 WD
 
1473
Wide displays, wide also in two-column mode.
 
1474
.T2 -WD
 
1475
Normal display width, follow column mode.
 
1476
.T2 FB
 
1477
Floating displays generates a line break when printed on the current page.
 
1478
.T2 -FB
 
1479
Floating displays does not generate line break.
 
1480
.in
 
1481
.sp 3
 
1482
.LP
 
1483
.\"########################################################################
 
1484
.LP
 
1485
.B "Strings used in m@TMAC_M_PREFIX@m:"
 
1486
.TP
 
1487
.B App
 
1488
A string containing the word "APPENDIX".
 
1489
.TP
 
1490
.B Apptxt
 
1491
.TP
 
1492
The current appendix text.
 
1493
.B "EM"
 
1494
Em dash string
 
1495
.TP
 
1496
.B H1txt
 
1497
Will be updated by \fB.H\fP and \fB.HU\fP to the current heading text.
 
1498
Also updated in table of contents & friends.
 
1499
.TP
 
1500
.B HF
 
1501
Fontlist for headings, normally "2 2 2 2 2 2 2".
 
1502
Nonnumeric fontnames may also be used.
 
1503
.TP
 
1504
.B HP
 
1505
Pointsize list for headings. Normally "0 0 0 0 0 0 0" which is the same as
 
1506
"10 10 10 10 10 10 10".
 
1507
.TP
 
1508
.B Index
 
1509
.TP
 
1510
Contains \fIINDEX\fP.
 
1511
.B Indcmd
 
1512
.TP
 
1513
Contains the index command, \fIsort\ -t\et\fP.
 
1514
.B Lifg
 
1515
String containing \fIFigure\fP.
 
1516
.TP
 
1517
.B Litb
 
1518
String containing \fITABLE\fP.
 
1519
.TP
 
1520
.B Liex
 
1521
String containing \fIExhibit\fP.
 
1522
.TP
 
1523
.B Liec
 
1524
String containing \fIEquation\fP.
 
1525
.TP
 
1526
.B Licon
 
1527
String containing \fICONTENTS\fP.
 
1528
.TP
 
1529
.B Lf
 
1530
Contains "LIST OF FIGURES".
 
1531
.TP
 
1532
.B Lt
 
1533
Contains "LIST OF TABLES".
 
1534
.TP
 
1535
.B Lx
 
1536
Contains "LIST OF EXHIBITS".
 
1537
.TP
 
1538
.B Le
 
1539
Contains "LIST OF EQUATIONS".
 
1540
.TP
 
1541
.B Letfc
 
1542
Contains "Yours very truly,", used in \fB.FC\fP.
 
1543
.TP
 
1544
.B Letapp
 
1545
Contains "APPROVED:", used in \fB.AV\fP.
 
1546
.TP
 
1547
.B Letdate
 
1548
Contains "Date", used in \fB.AV\fP.
 
1549
.TP
 
1550
.B LetCN
 
1551
Contains "CONFIDENTIAL", used in \fB.LO CN\fP.
 
1552
.TP
 
1553
.B LetSA
 
1554
Contains "To Whom It May Concern:", used in \fB.LO SA\fP.
 
1555
.TP
 
1556
.B LetAT
 
1557
Contains "ATTENTION:", used in \fB.LO AT\fP.
 
1558
.TP
 
1559
.B LetSJ
 
1560
Contains "SUBJECT:", used in \fB.LO SJ\fP.
 
1561
.TP
 
1562
.B LetRN
 
1563
Contains "In reference to:", used in \fB.LO RN\fP.
 
1564
.TP
 
1565
.B Letns
 
1566
is an array containing the different strings used in \fB.NS\fP.
 
1567
It is really a number of stringvariables prefixed with \fBLetns!\fP.
 
1568
If the argument doesn't exist, it will be included
 
1569
between \fB()\fP with \fBLetns!copy\fP as prefix and \fBLetns!to\fP as suffix.
 
1570
Observe the space after \fBcopy\fP and before \fBto\fP.
 
1571
.nf
 
1572
.ta 1.5i
 
1573
\fBName Value\fP
 
1574
Letns!0 Copy to
 
1575
Letns!1 Copy (with att.) to
 
1576
Letns!2 Copy (without att.) to
 
1577
Letns!3 Att.
 
1578
Letns!4 Atts.
 
1579
Letns!5 Enc.
 
1580
Letns!6 Encs.
 
1581
Letns!7 Under separate cover
 
1582
Letns!8 Letter to
 
1583
Letns!9 Memorandum to
 
1584
Letns!10        Copy (with atts.) to
 
1585
Letns!11        Copy (without atts.) to
 
1586
Letns!12        Abstract Only to
 
1587
Letns!13        Complete Memorandum to
 
1588
Letns!14        CC
 
1589
Letns!copy      Copy "
 
1590
Letns!to        " to
 
1591
.fi
 
1592
.TP
 
1593
.B Letnsdef
 
1594
Defines the standard-notation used when no argument is given
 
1595
to \fB.NS\fP. Default is \fB0\fP.
 
1596
.TP
 
1597
.B "MO1 - MO12"
 
1598
Strings containing \fIJanuary\fP thru \fIDecember\fP.
 
1599
.TP
 
1600
.B Qrf
 
1601
String containing "See chapter \e\e*[Qrfh], page \e\en[Qrfp].".
 
1602
.TP
 
1603
.B Rp
 
1604
Contains "REFERENCES".
 
1605
.TP
 
1606
.B Tcst
 
1607
Contains current status of table of contents and list of XXXX.
 
1608
Empty outside \fB.TC\fP.
 
1609
Useful in user-defined macros like \fB.TP\fP.
 
1610
.nf
 
1611
.ta 1.5i
 
1612
\fBValue        Meaning\fP
 
1613
co      Table of contents
 
1614
fg      List of figures
 
1615
tb      List of tables
 
1616
ec      List of equations
 
1617
ex      List of exhibits
 
1618
ap      Appendix
 
1619
.fi
 
1620
.ta
 
1621
.TP
 
1622
.B Tm
 
1623
Contains \e(tm, trade mark.
 
1624
.TP
 
1625
.B Verbnm
 
1626
Argument to \fB.nm\fP in \fB.VERBON\fP, default: \fB1\fP.
 
1627
.\"-----------------------------------
 
1628
.LP
 
1629
.B "Number variables used in m@TMAC_M_PREFIX@m:"
 
1630
.TP
 
1631
.B Aph
 
1632
Print an appendix-page for every new appendix 
 
1633
if this numbervariable is non-zero.
 
1634
No output will occur if \fBAph\fP is zero, but there will always
 
1635
be an appendix-entry in the 'List of contents'.
 
1636
.TP
 
1637
.B Cl
 
1638
Contents level [0:7], contents saved if heading level <= Cl, default 2.
 
1639
.TP
 
1640
.B Cp
 
1641
Eject page between LIST OF XXXX if Cp == 0, default 0.
 
1642
.TP
 
1643
.B D
 
1644
Debugflag, values >0 produces varying degree of debug. A value of 1
 
1645
gives information about the progress of formatting, default 0.
 
1646
.TP
 
1647
.B De
 
1648
Eject after floating display is output [0:1], default 0.
 
1649
.TP
 
1650
.B Dsp
 
1651
Controls the space output before and after static displays
 
1652
if defined. Otherwise is the value of Lsp used.
 
1653
.TP
 
1654
.B Df
 
1655
Floating keep output [0:5], default 5.
 
1656
.TP
 
1657
.B Ds
 
1658
\fBLsp\fP space before and after display if == 1 [0:1], default 1.
 
1659
.TP
 
1660
.B Ej
 
1661
Eject page, default 0.
 
1662
.TP
 
1663
.B Eq
 
1664
Equation lable adjust 0=left, 1=right. Default 0.
 
1665
.TP
 
1666
.B Fs
 
1667
Footnote spacing, default 1.
 
1668
.TP
 
1669
.B "H1-H7"
 
1670
Heading counters
 
1671
.TP
 
1672
.B H1dot
 
1673
Append a dot after the level one heading number if > 0. Default is 1.
 
1674
.TP
 
1675
.B H1h
 
1676
.TP
 
1677
Copy of number register \fBH1\fP, but it is incremented
 
1678
just before the page break. Useful in user defined header macros.
 
1679
.B Hb
 
1680
Heading break level [0:7], default 2.
 
1681
.TP
 
1682
.B Hc
 
1683
Heading centering level, [0:7]. Default 0.
 
1684
.TP
 
1685
.B Hi
 
1686
Heading temporary indent [0:2], default 1.
 
1687
.br
 
1688
0\ ->\ 0 indent, left margin
 
1689
.br
 
1690
1\ ->\ indent to right , like .P 1
 
1691
.br
 
1692
2\ ->\ indent to line up with text part of preceding heading
 
1693
.TP
 
1694
.B Hps
 
1695
Numbervariable with the heading pre-space level. If the heading-level
 
1696
is less than or equal to \fBHps\fP, then two lines will precede the
 
1697
section heading instead of one. Default is first level only.
 
1698
The real amount of lines is controlled by the variables \fBHps1\fP and
 
1699
\fBHps2\fP.
 
1700
.TP
 
1701
.B Hps1
 
1702
This is the number of lines preceding \fB.H\fP when the heading-level
 
1703
is greater than \fBHps\fP. Value is in units, normally 0.5.
 
1704
.TP
 
1705
.B Hps2
 
1706
This is the number of lines preceding \fB.H\fP when the heading-level
 
1707
is less than or equal to \fBHps\fP. Value is in units, normally 1.
 
1708
.TP
 
1709
.B Hs
 
1710
Heading space level [0:7], default 2.
 
1711
.TP
 
1712
.B Hss
 
1713
This is the number of lines that follows \fB.H\fP when the heading-level
 
1714
is less than or equal to \fBHs\fP. Value is in units, normally 1.
 
1715
.TP
 
1716
.B Ht
 
1717
Heading numbering type, default 0.
 
1718
0 -> multiple (1.1.1 ...)
 
1719
.br
 
1720
1 -> single
 
1721
.TP
 
1722
.B Hu
 
1723
Unnumbered heading level, default 2.
 
1724
.TP
 
1725
.B Hy
 
1726
Hyphenation in body, default 1.
 
1727
.br
 
1728
0\ ->\ no hyphenation
 
1729
.br
 
1730
1\ ->\ hyphenation 14 on
 
1731
.TP
 
1732
.B Iso
 
1733
Set this variable to 1 on the command line to get ISO-formatted date string.
 
1734
(\fB-rIso=1\fP)
 
1735
Useless inside a document.
 
1736
.TP
 
1737
.B Letwam
 
1738
Max lines in return-address, used in \fB.WA\fP/\fB.WE\fP. Default 14.
 
1739
.TP
 
1740
.B "Lf, Lt, Lx, Le"
 
1741
Enables (1) or disables (0) the printing of List of figures,
 
1742
List of tables, List of exhibits and List of equations.
 
1743
Default: Lf=1, Lt=1, Lx=1, Le=0.
 
1744
.TP
 
1745
.B Li
 
1746
List indent, used by .AL, default 6.
 
1747
.TP
 
1748
.B Limsp
 
1749
Flag for space between prefix and mark in automatic lists (.AL).
 
1750
.br
 
1751
0\ ==\ no space
 
1752
.br
 
1753
1\ ==\ space
 
1754
.TP
 
1755
.B Ls
 
1756
List space, if current listlevel > Ls then no spacing will occur around lists.
 
1757
Default 99.
 
1758
.TP
 
1759
.B Lsp
 
1760
The size of an empty line. Normally 0.5v, but it is 1v 
 
1761
if \fBn\fP is set (\fB.nroff\fP).
 
1762
.TP
 
1763
.B N
 
1764
Numbering style [0:5], default 0.
 
1765
.br
 
1766
0\ ==\ (default) normal header for all pages.
 
1767
.br
 
1768
1\ ==\ header replaces footer on first page, header is empty.
 
1769
.br
 
1770
2\ ==\ page header is removed on the first page.
 
1771
.br
 
1772
3\ ==\ "section-page" numbering enabled.
 
1773
.br
 
1774
4\ ==\ page header is removed on the first page.
 
1775
.br
 
1776
5\ ==\ "section-page" and "section-figure" numbering enabled.
 
1777
See also the number-register Sectf and Sectp.
 
1778
.TP
 
1779
.B Np
 
1780
Numbered paragraphs, default 0.
 
1781
.br
 
1782
0\ ==\ not numbered
 
1783
.br
 
1784
1\ ==\ numbered in first level headings.
 
1785
.TP
 
1786
.B Of
 
1787
Format of figure,table,exhibit,equation titles, default 0.
 
1788
.br
 
1789
0\ =\ ". "
 
1790
.br
 
1791
1\ =\ " - "
 
1792
.TP
 
1793
.B P
 
1794
Current page-number, normally the same as % unless "section-page" numbering
 
1795
is enabled.
 
1796
.TP
 
1797
.B Pi
 
1798
paragraph indent, default 5.
 
1799
.TP
 
1800
.B Pgps
 
1801
Controls whether header and footer pointsize should follow the current
 
1802
setting or just change when the header and footer is defined.
 
1803
.in +.5i
 
1804
.ti -.5i
 
1805
.T2 Value
 
1806
Description
 
1807
.T2 0
 
1808
Pointsize will only change to the current setting when \fB.PH\fP, \fB.PF\fP,
 
1809
\&\fB.OH\fP, \fP.EH\fP, \fB.OF\fP or \fB.OE\fP is executed.
 
1810
.T2 1
 
1811
Pointsize will change after every \fB.S\fP. This is the default.
 
1812
.in
 
1813
.TP
 
1814
.B Ps
 
1815
paragraph spacing, default 1.
 
1816
.TP
 
1817
.B Pt
 
1818
Paragraph type, default 0.
 
1819
.br
 
1820
0\ ==\ left-justified
 
1821
.br
 
1822
1\ ==\ indented .P
 
1823
.br
 
1824
2\ ==\ indented .P except after .H, .DE or .LE.
 
1825
.TP
 
1826
.B Sectf
 
1827
Flag controlling "section-figures". A non-zero value enables this.
 
1828
See also register N.
 
1829
.TP
 
1830
.B Sectp
 
1831
Flag controlling "section-page-numbers". A non-zero value enables this.
 
1832
See also register N.
 
1833
.TP
 
1834
.B Si
 
1835
Display indent, default 5.
 
1836
.TP
 
1837
.B Verbin
 
1838
Indent for \fB.VERBON\fP, default 5n.
 
1839
.TP
 
1840
.B .mgm
 
1841
Always 1.
 
1842
.LP
 
1843
.SH INTERNALS
 
1844
The letter macros is using different submacros depending on
 
1845
the letter type. The name of the submacro has the letter type
 
1846
as suffix. It is therefore possible to define other letter types, either
 
1847
in the national macro-file, or as local additions.
 
1848
\&\fB.LT\fP will set the number variables \fBPt\fP and \fBPi\fP to 0 and 5.
 
1849
The following strings and macros must be defined for a new letter type:
 
1850
.TP
 
1851
\fBlet@init_\fP\fItype\fP
 
1852
This macro is called directly by \fB.LT\fP. It is supposed to initialize
 
1853
variables and other stuff.
 
1854
.TP
 
1855
\fBlet@head_\fP\fItype\fP
 
1856
This macro prints the letter head, and is called instead of the
 
1857
normal page header. It is supposed to remove the alias \fBlet@header\fP,
 
1858
otherwise it will be called for all pages.
 
1859
.TP
 
1860
\fBlet@sg_\fP\fItype\ name\ title\ n\ flag\ [arg1\ [arg2\ [...]]]\fP
 
1861
\&\fB.SG\fP is calling this macro only for letters, memorandums has
 
1862
its own processing. \fIname\fP and \fItitle\fP is specified
 
1863
thru \fB.WA\fP/\fB.WB\fP. \fIn\fP is the counter, 1-max, and
 
1864
\fIflag\fP is true for the last name. Any other argument to \fB.SG\fP
 
1865
is appended.
 
1866
.TP
 
1867
\fBlet@fc_\fP\fItype\ closing\fP
 
1868
This macro is called by \fB.FC\fP, and has the
 
1869
formal closing as argument.
 
1870
.LP
 
1871
\&\fB.LO\fP is implemented as a general option-macro. \fB.LO\fP demands
 
1872
that a string named \fBLet\fP\fItype\fP is defined, where \fItype\fP
 
1873
is the letter type.
 
1874
\&\fB.LO\fP will then assign the argument to the string
 
1875
variable \fBlet*lo-\fP\fItype\fP.
 
1876
.LP
 
1877
.\".SH BUGS
 
1878
.SH AUTHOR
 
1879
J�rgen H�gg, Lund, Sweden <jh@axis.se>.
 
1880
.SH FILES
 
1881
.TP
 
1882
.B @MACRODIR@/tmac.@TMAC_M_PREFIX@m
 
1883
.TP
 
1884
.B @TMAC_MDIR@/*.cov
 
1885
.TP
 
1886
.B @TMAC_MDIR@/*.MT
 
1887
.TP
 
1888
.B @TMAC_MDIR@/locale
 
1889
.SH "SEE ALSO"
 
1890
.BR groff (@MAN1EXT@),
 
1891
.BR @g@troff (@MAN1EXT@),
 
1892
.BR @g@tbl (@MAN1EXT@),
 
1893
.BR @g@pic (@MAN1EXT@),
 
1894
.BR @g@eqn (@MAN1EXT@)
 
1895
.br
 
1896
.BR mm (@MAN7EXT@)
 
1897
.BR m@TMAC_M_PREFIX@mse (@MAN7EXT@)
 
1898
.
 
1899
.\" Local Variables:
 
1900
.\" mode: nroff
 
1901
.\" End: