216 lines
11 KiB
Plaintext
216 lines
11 KiB
Plaintext
MN(7) Miscellaneous Information Manual MN(7)
|
|
|
|
|
|
|
|
NAME
|
|
mn - text formatting macros for the news documentation
|
|
|
|
SYNOPSIS
|
|
nroff -mn [ options ] file ...
|
|
troff -mn [ options ] file ...
|
|
|
|
DESCRIPTION
|
|
This package of nroff(1) and troff(1) macro definitions provides a for-
|
|
matting facility which may be used to run off the formatted news docu-
|
|
ments. When reverse line motions are needed, filter the output through
|
|
col(1).
|
|
|
|
All -mn macros, diversions, string registers, and number registers are
|
|
defined below. Many nroff and troff requests are unsafe in conjunction
|
|
with this package. However, the requests below may be used with im-
|
|
punity:
|
|
|
|
.bp begin new page
|
|
.br break output line
|
|
.sp n insert n spacing lines
|
|
.ce n center next n lines
|
|
.ls n line spacing: n=1 single, n=2 double space
|
|
.na no alignment of right margin
|
|
|
|
Font and point size changes with \f and \s are also allowed; for exam-
|
|
ple, ``\f2word\fR'' will italicize word. Output of the tbl(1), eqn(1),
|
|
and refer(1) preprocessors for equations, tables, and references is ac-
|
|
ceptable as input.
|
|
|
|
FILES
|
|
/usr/lib/tmac/tmac.n
|
|
|
|
SEE ALSO
|
|
eqn(1), refer(1), tbl(1), troff(1)
|
|
|
|
WARNINGS
|
|
If you do not set the string register ``.f'' to the file name, you will
|
|
only be told the line number on which any errors occur. If you define
|
|
this string to be the file name, you will get the file name, too. This
|
|
is useful when dealing with a document split up into many files.
|
|
|
|
This package is not now intended for uses other than with the news doc-
|
|
umentation.
|
|
|
|
Bug reports are always welcome; please send them to the author. (In-
|
|
clude a sample of the input; this helps track down the bug.)
|
|
|
|
AUTHOR
|
|
Matt Bishop (mab@riacs.arpa, ihnp4!ames!riacs!mab, decvax!decwrl!ri-
|
|
acs!mab)
|
|
Updated for versions 1.4-1.6 by The NetHack Development Team
|
|
|
|
REQUESTS
|
|
In the Note column, b means the request causes a break, and i means the
|
|
macro, number register, string register, or diversion is internal and
|
|
should not be used for anything. In the What It Is column, div means
|
|
diversion, mac means macro, num means number register, and str means
|
|
string register. In the Initial Value column, a hyphen means no ini-
|
|
tial value is used, anything else is the initial value, and if two val-
|
|
ues are given, the first is for nroff and the second for troff.
|
|
|
|
Macro What Initial Note Explanation
|
|
Name It Is Value
|
|
.f num - - file name, used in error messages if set
|
|
.ai mac - - author's institution
|
|
.au mac - b author's name
|
|
.b x y z mac - - print x in font 3, y after, z before;
|
|
if no arguments, switch to font 3
|
|
b num - i used to embolden italics
|
|
.bi x y z mac - - print x in emboldened font 2, y after,
|
|
z before
|
|
bm num 1i,1i+1v - height of bottom margin
|
|
.bt mac - - print pottom title
|
|
bt num .5i+1v - bottom of footer to bottom of page
|
|
.cf x y z mac - - print contents of header line (double
|
|
quotes around x, y before, z after)
|
|
cm num 0 - 0 if no cut marks, nonzero if cut marks
|
|
.cn x y z mac - - print computer/site name; same as .i
|
|
.dd div - i text of display
|
|
dg str *,<*> - footnote mark
|
|
dw str current - name of current day of week
|
|
dy str current - full date
|
|
.ed mac - b end display
|
|
.ef mac - b end footnote
|
|
.ei mac - b move left margin to the right
|
|
.er mac - - print error message
|
|
.et mac - b,i macro called at end of text
|
|
f0 str - - left bottom title
|
|
f1 num - i current font number
|
|
f1 str date,- - center bottom title
|
|
f2 num - i previous font number
|
|
f2 str - - right bottom title
|
|
fc num - i per-page footnote count
|
|
.fd mac - b,i drop footnotes
|
|
fg num - i gets fudge factor for footnote
|
|
fl num 5.5i - default footnote line length
|
|
.fn mac - - begin footnote
|
|
.fo mac - - bottom of page (footer) macro
|
|
fp num - i current location of trap for .fo macro
|
|
.fs mac - i print text/footnote separator
|
|
fs num - i position where footnote printing should begin
|
|
.fx mac - i collect overflow footnotes
|
|
.fy div - i text of footnote overflow
|
|
.fz mac - i move overflow footnotes from .fy to .tf
|
|
gs num - i used to be sure footnotes fit
|
|
h0 num 0 i current level 1 section number
|
|
h0 str - - left header title
|
|
h1 num 0 i current level 2 section number
|
|
h1 str - page - - center header title
|
|
h2 num 0 i current level 3 section number
|
|
h2 str - - right header title
|
|
h3 num 0 i current level 4 section number
|
|
.hd mac - i top of page (header) macro
|
|
.hf mac - - print header field name; same as .cf
|
|
.hn x mac - b numbered section; if present, x is level
|
|
hn num 0 i current level of numbering (temporary)
|
|
hs num 1v - default intra-section spacing
|
|
.hu mac - b unnumbered section header
|
|
.i x y z mac - - print x in font 2, y after, z before;
|
|
if no arguments, switch to font 2
|
|
i1 num - i current indent
|
|
i2 num - i previous indent
|
|
id num 0 i 1 if in display, 0 otherwise
|
|
if num 0 i 1 if in footnote, 0 otherwise
|
|
.is x y z mac - - print x 2p bigger, y after, z before;
|
|
if no arguments, increase point size by 2p
|
|
it num 0 i 0 before .bt called, 1 after
|
|
l0 num 0 i leftmost position for left margin
|
|
l1 num - i first level of indent for left margin
|
|
l2 num - i second level of indent for left margin
|
|
l3 num - i third level of indent for left margin
|
|
l4 num - i fourth level of indent for left margin
|
|
l5 num - i fifth level of indent for left margin
|
|
l6 num - i sixth level of indent for left margin
|
|
l7 num - i seventh level of indent for left margin
|
|
l8 num - i eighth level of indent for left margin
|
|
l9 num - i ninth level of indent for left margin
|
|
li num 5n - paragraph indent
|
|
ll num 6i - default line length
|
|
lm num 0 i current level of indent for left margin
|
|
lo num - i previous level for left margin
|
|
.lp x y mac - b labelled paragraph; x is label, y indent
|
|
lq str ",`` - left double quotation marks
|
|
mo str current - name of current month
|
|
.mt mac - b title
|
|
mt num 1.5i+1v - distance of title from top of page
|
|
.ng x y z mac - - newsgroup name; same as .b
|
|
.nl mac - b reset point size to default
|
|
ns num 0 i if nonzero, .fn does not call .fs
|
|
.op x y z mac - - command option; same as .b
|
|
p1 num 0 i 1 after PDP-11(tm) footnote printed,
|
|
0 before
|
|
.pa x y z mac - - print protocol appellation; same as .i
|
|
.pd x y mac - - print PDP-11(tm), footnote; x after,
|
|
y before
|
|
pd num 1v,.3v - intra-paragraph spacing
|
|
.pf mac - - print footer title
|
|
.pg x mac - b paragraph; if x is l, left justify
|
|
pi num 5n - default paragraph indent
|
|
po num 1.25i - default page offset
|
|
ps num 12p - default point size
|
|
.pt x mac - - print header; x is distance from top of
|
|
page
|
|
.qc x y z mac - - print name of control char; x is name,
|
|
in font 3, between <>, y after, z before
|
|
.qp x y z mac - - print char; same as .b
|
|
.r mac - - switch to font 1
|
|
rg str - - registered trademark symbol
|
|
rq str ",'' - right double quotation marks
|
|
s1 num - i current point size
|
|
s2 num - i previous point size
|
|
.sd x mac - - start display; if x is c, center display
|
|
sf num - i 1 if center display, 0 otherwise
|
|
.si x num - - indent left margin by x (5n default)
|
|
.sm x y z mac - - print x 2p smaller, y after, z before;
|
|
if no arguments, decrease point size by 2p
|
|
.sn x mac - b space by x (1v default), enter nospace mode
|
|
.sr x mac - - enter spacemode, space by x (1v default)
|
|
t2 num 0 i 0 if little/no space, nonzero otherwise
|
|
.tf div - i text of footnotes
|
|
tm num 1i-.5v - height of top margin
|
|
tt num .5i-.5v - distance from top of page to header
|
|
.ux x y mac - - print UNIX(tm), footnote; x after,
|
|
y before
|
|
ux num 0 i 1 after UNIX(tm) footnote printed,
|
|
0 before
|
|
v1 num - i current vertical spacing
|
|
v2 num - i previous vertical spacing
|
|
vr str - - current version of news
|
|
vs num 16p - default vertical spacing
|
|
vx num 0 i 1 after VAX(tm) footnote printed,
|
|
0 before
|
|
.vx x y mac - - print VAX(tm), footnote; x after,
|
|
y before
|
|
ws str - - used to construct error message
|
|
.ya mac - - same as calling .yf, .yi, .ys, .yv
|
|
.yf mac - - restore fonts saved by .zf
|
|
.yi mac - - restore indents saved by .zi
|
|
Yr str - - current year
|
|
.ys mac - - restore point sizes saved by .zs
|
|
.yv mac - - restore vertical spacings saved by .zv
|
|
.za mac - - same as calling .zf, .zi, .zs, .zv
|
|
.zf mac - - save previous, current fonts
|
|
.zi mac - - save previous, current indents
|
|
.zs mac - - save previous, current point sizes
|
|
.zv mac - - save previous, current vertical spacings
|
|
|
|
|
|
|
|
News Version B2.11 MN(7)
|