![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to mn.7 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSD / contrib / news / doc|
Return to mn.7 CVS log | Up to [CSRG BSD Unix] / 43BSD / contrib / news / doc |
1.1 root 1: .TH MN 7 "News Version B2.10.3"
2: .SH NAME
3: mn \- text formatting macros for the news documentation
4: .SH SYNOPSIS
5: .B "nroff \-mn"
6: [ options ] file ...
7: .br
8: .B "troff \-mn"
9: [ options ] file ...
10: .SH DESCRIPTION
11: .PP
12: This package of
13: .IR nroff (1)
14: and
15: .IR troff (1)
16: macro definitions provides a formatting facility
17: which may be used to run off the formatted news documents.
18: When reverse line motions are needed,
19: filter the output through
20: .IR col (1).
21: .PP
22: All \-mn macros,
23: diversions,
24: string registers,
25: and number registers are defined below.
26: Many
27: .I nroff
28: and
29: .I troff
30: requests are unsafe in conjunction with this package.
31: However,
32: the requests below may be used with impunity:
33: .LP
34: .ta 5n 12n
35: .nf
36: .bp begin new page
37: .br break output line
38: .sp \f2n\fP insert \f2n\fP spacing lines
39: .ce \f2n\fP center next \f2n\fP lines
40: .ls \f2n\fP line spacing: \f2n\fP=1 single, \f2n\fP=2 double space
41: .na no alignment of right margin
42: .fi
43: .PP
44: Font and point size changes with \ef and \es are also allowed;
45: for example,
46: \&``\ef2word\efR'' will italicize \f2word.\fP
47: Output of the
48: .IR tbl (1),
49: .IR eqn (1),
50: and
51: .IR refer (1)
52: preprocessors for equations,
53: tables,
54: and references is acceptable as input.
55: .SH FILES
56: /usr/lib/tmac/tmac.n
57: .SH "SEE ALSO"
58: eqn(1), refer(1), tbl(1), troff(1)
59: .SH WARNINGS
60: .PP
61: If you do not set the string register ``.f'' to the file name,
62: you will only be told the line number on which any errors occur.
63: If you define this string to be the file name,
64: you will get the file name,
65: too.
66: This is useful when dealing with a document
67: split up into many files.
68: .PP
69: This package is not now intended for uses
70: other than with the news documentation.
71: .PP
72: Bug reports are always welcome;
73: please send them to the author.
74: (Include a sample of the input;
75: this helps track down the bug.)
76: .SH AUTHOR
77: Matt Bishop
78: .RI ( [email protected] ,
79: .IR ihnp4!ames!riacs!mab ,
80: .IR decvax!decwrl!riacs!mab )
81: .SH REQUESTS
82: .PP
83: In the
84: .I Note
85: column,
86: .I b
87: means the request causes a break,
88: and
89: .I i
90: means the macro,
91: number register,
92: string register,
93: or diversion is internal and should not be used for anything.
94: In the
95: .I "What It Is"
96: column,
97: .IR div " means " diversion ,
98: .IR mac " means " macro ,
99: .IR num " means " "number register" ,
100: and
101: .IR str " means " "string register" .
102: In the
103: .I "Initial Value"
104: column,
105: a hyphen means no initial value is used,
106: anything else is the initial value,
107: and if two values are given,
108: the first is for
109: .I nroff
110: and the second for
111: .IR troff .
112: .PP
113: .if n .in 0
114: .ds x \f2x\fP\|
115: .ds y \f2y\fP\|
116: .ds z \f2z\fP\|
117: .ds X "\*x
118: .ds Y "\*x \*y
119: .ds Z "\*x \*y \*z
120: .tr _.
121: .ta \w'MacroNames'u +\w'WhatItIs'u +\w'InitialVal'u +\w'Note 'u
122: .sp .3
123: .nf
124: Macro What Initial Note \0 Explanation
125: Name It Is Value
126: .sp .3
127: _f num \- \- file name, used in error messages if set
128: _ai mac \- \- author's institution
129: _au mac \- b author's name
130: _b \*Z mac \- \- print \*x in font 3, \*y after, \*z before;
131: if no arguments, switch to font 3
132: b num \- i used to embolden italics
133: _bi \*Z mac \- \- print \*x in emboldened font 2, \*y after,
134: \*z before
135: bm num 1i,1i+1v \- height of bottom margin
136: _bt mac \- \- print pottom title
137: bt num .5i+1v \- bottom of footer to bottom of page
138: _cf \*Z mac \- \- print contents of header line (double
139: quotes around \*x, \*y before, \*z after)
140: cm num 0 \- 0 if no cut marks, nonzero if cut marks
141: _cn \*Z mac \- \- print computer/site name; same as _i
142: _dd div \- i text of display
143: dg str \(**,\(dg \- footnote mark
144: dw str \f2current\fP \- name of current day of week
145: dy str \f2current\fP \- full date
146: _ed mac \- b end display
147: _ef mac \- b end footnote
148: _ei mac \- b move left margin to the right
149: _er mac \- \- print error message
150: _et mac \- b,i macro called at end of text
151: f0 str \- \- left bottom title
152: f1 num \- i current font number
153: f1 str \f2date\fP,\- \- center bottom title
154: f2 num \- i previous font number
155: f2 str \- \- right bottom title
156: fc num \- i per-page footnote count
157: _fd mac \- b,i drop footnotes
158: fg num \- i gets fudge factor for footnote
159: fl num 5.5i \- default footnote line length
160: _fn mac \- \- begin footnote
161: _fo mac \- \- bottom of page (footer) macro
162: fp num \- i current location of trap for _fo macro
163: _fs mac \- i print text/footnote separator
164: fs num \- i position where footnote printing should begin
165: _fx mac \- i collect overflow footnotes
166: _fy div \- i text of footnote overflow
167: _fz mac \- i move overflow footnotes from _fy to _tf
168: gs num \- i used to be sure footnotes fit
169: h0 num 0 i current level 1 section number
170: h0 str \- \- left header title
171: h1 num 0 i current level 2 section number
172: h1 str \f2\- page \-\fP \- center header title
173: h2 num 0 i current level 3 section number
174: h2 str \- \- right header title
175: h3 num 0 i current level 4 section number
176: _hd mac \- i top of page (header) macro
177: _hf mac \- \- print header field name; same as _cf
178: _hn \*x mac \- b numbered section; if present, \*x is level
179: hn num 0 i current level of numbering (temporary)
180: hs num 1v \- default intra-section spacing
181: _hu mac \- b unnumbered section header
182: _i \*Z mac \- \- print \*x in font 2, \*y after, \*z before;
183: if no arguments, switch to font 2
184: i1 num \- i current indent
185: i2 num \- i previous indent
186: id num 0 i 1 if in display, 0 otherwise
187: if num 0 i 1 if in footnote, 0 otherwise
188: _is \*Z mac \- \- print \*x 2p bigger, \*y after, \*z before;
189: if no arguments, increase point size by 2p
190: it num 0 i 0 before _bt called, 1 after
191: l0 num 0 i leftmost position for left margin
192: l1 num \- i first level of indent for left margin
193: l2 num \- i second level of indent for left margin
194: l3 num \- i third level of indent for left margin
195: l4 num \- i fourth level of indent for left margin
196: l5 num \- i fifth level of indent for left margin
197: l6 num \- i sixth level of indent for left margin
198: l7 num \- i seventh level of indent for left margin
199: l8 num \- i eighth level of indent for left margin
200: l9 num \- i ninth level of indent for left margin
201: li num 5n \- paragraph indent
202: ll num 6i \- default line length
203: lm num 0 i current level of indent for left margin
204: lo num \- i previous level for left margin
205: _lp \*Y mac \- b labelled paragraph; \*x is label, \*y indent
206: lq str ",`` \- left double quotation marks
207: mo str \f2current\fP \- name of current month
208: _mt mac \- b title
209: mt num 1.5i+1v \- distance of title from top of page
210: _ng \*Z mac \- \- newsgroup name; same as _b
211: _nl mac \- b reset point size to default
212: ns num 0 i if nonzero, _fn does not call _fs
213: _op \*Z mac \- \- command option; same as _b
214: p1 num 0 i 1 after PDP-11(tm) footnote printed,
215: 0 before
216: _pa \*Z mac \- \- print protocol appellation; same as _i
217: _pd \*Y mac \- \- print PDP-11(tm), footnote; \*x after,
218: \*y before
219: pd num 1v,.3v \- intra-paragraph spacing
220: _pf mac \- \- print footer title
221: _pg \*x mac \- b paragraph; if \*x is l, left justify
222: pi num 5n \- default paragraph indent
223: po num 1.25i \- default page offset
224: ps num 12p \- default point size
225: _pt \*x mac \- \- print header; \*x is distance from top of
226: page
227: _qc \*Z mac \- \- print name of control char; \*x is name,
228: in font 3, between <>, \*y after, \*z before
229: _qp \*Z mac \- \- print char; same as _b
230: _r mac \- \- switch to font 1
231: rq str ",'' \- right double quotation marks
232: s1 num \- i current point size
233: s2 num \- i previous point size
234: _sd \*X mac \- \- start display; if \*x is c, center display
235: sf num \- i 1 if center display, 0 otherwise
236: _si \*x num \- \- indent left margin by \*x (5n default)
237: _sm \*Z mac \- \- print \*x 2p smaller, \*y after, \*z before;
238: if no arguments, decrease point size by 2p
239: _sn \*x mac \- b space by \*x (1v default), enter nospace mode
240: _sr \*x mac \- \- enter spacemode, space by \*x (1v default)
241: t2 num 0 i 0 if little/no space, nonzero otherwise
242: _tf div \- i text of footnotes
243: tm num 1i-.5v \- height of top margin
244: tt num .5i-.5v \- distance from top of page to header
245: _ux \*Y mac \- \- print UNIX(tm), footnote; \*x after,
246: \*y before
247: ux num 0 i 1 after UNIX(tm) footnote printed,
248: 0 before
249: v1 num \- i current vertical spacing
250: v2 num \- i previous vertical spacing
251: vr str \- \- current version of news
252: vs num 16p \- default vertical spacing
253: vx num 0 i 1 after VAX(tm) footnote printed,
254: 0 before
255: _vx \*Y mac \- \- print VAX(tm), footnote; \*x after,
256: \*y before
257: ws str \- \- used to construct error message
258: _ya mac \- \- same as calling _yf, _yi, _ys, _yv
259: _yf mac \- \- restore fonts saved by _zf
260: _yi mac \- \- restore indents saved by _zi
261: _ys mac \- \- restore point sizes saved by _zs
262: _yv mac \- \- restore vertical spacings saved by _zv
263: _za mac \- \- same as calling _zf, _zi, _zs, _zv
264: _zf mac \- \- save previous, current fonts
265: _zi mac \- \- save previous, current indents
266: _zs mac \- \- save previous, current point sizes
267: _zv mac \- \- save previous, current vertical spacings
268: .fi
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.