--- /dev/null
+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
+ impunity:
+
+ .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
+ acceptable 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.
+ (Include a sample of the input; this helps track down the bug.)
+
+AUTHOR
+ Matt Bishop (mab@riacs.arpa, ihnp4!ames!riacs!mab, dec-
+ vax!decwrl!riacs!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)