|
|
1.1 root 1: .TH MPM 6
2: .CT 1 writing_troff
3: .SH NAME
4: mpm \- macros for page makeup
5: .SH SYNOPSIS
6: .B troff -mpm
7: .I file ...
8: .SH DESCRIPTION
9: These
10: .IR troff (1)
11: macros, largely compatible with
12: .IR ms (6),
13: make better pages.
14: They silently invoke and provide information to a
15: postprocessor that moves floating figures, avoids widows, and justifies
16: pages vertically by stretching vertical spaces that result from
17: .BR .PP ,
18: .BR .LP ,
19: .BR .IP ,
20: .BR .QP ,
21: .BR .SH ,
22: .BR .NH ,
23: .BR .DS / .DE ,
24: .BR .EQ / .EN ,
25: .BR .TS / .TE ,
26: .BR .PS / .PE ,
27: .BR .P1 / .P2 ,
28: and
29: .BR .QS / .QE .
30: .PP
31: The following macros are different from or not part of
32: .BR -ms .
33: Values denoted
34: .I n
35: have default value
36: .BR 1v .
37: .TP
38: .BR .BP
39: Begin a new page.
40: .PD 0
41: .TP
42: .B .FL
43: Flush: force out previous keeps.
44: .TP
45: .B .FC
46: Finish a two-column region and start a new one.
47: .TP
48: .BI .KF \ m
49: Floating keep, with preferred center at vertical position
50: .IR m .
51: Special values
52: .L top
53: (default) and
54: .L bottom
55: are permitted.
56: .TP
57: .BI .NE \ n
58: Start new page if remaining vertical space on this page
59: is less than
60: .I n .
61: .TP
62: .B .P1
63: Begin a program display (Courier font).
64: .TP
65: .B .P2
66: End a program display.
67: .TP
68: .BI .P3
69: Insert optional break point in program display.
70: .TP
71: .BI .SP " n " exactly
72: .br
73: .ns
74: .TP
75: .BI .SP " n "
76: Insert fixed or stretchable vertical space of height
77: .I n.
78: .TP
79: .BI .Tm " text"
80: Place page number and
81: .I text
82: on the standard error output.
83: .TP
84: .BI .X " text"
85: Present
86: .I text
87: to the hidden page-makeup program
88: as part of a device-dependent output sequence
89: .BR x
90: .BR X
91: .IR "text" .
92: Equivalent to
93: .BI \eX' text ' .
94: .PD
95: .PP
96: Useful number registers:
97: .PD 0
98: .TP
99: .B HM
100: Header margin; default 1 inch.
101: .TP
102: .B FM
103: Footer margin; default 1 inch.
104: .TP
105: .B FO
106: Footer position; default 10 inches.
107: .TP
108: .B %#
109: Page number of current page.
110: .TP
111: .BR dP , dV
112: Shrinkage of point size and vertical spacing for
113: .BR .P1 ,
114: in points.
115: .PD
116: .PP
117: Useful strings:
118: .PD 0
119: .TP
120: .BR %e , %o
121: Even and odd page title commands, as
122: .BR .tl\ '''' .
123: .PD
124: .SH FILES
125: .F /usr/lib/tmac/tmac.pm
126: .br
127: .F /usr/lib/tmac/pm
128: .SH "SEE ALSO"
129: .IR ms (6),
130: .IR troff (1)
131: .br
132: B. W. Kernighan and C. J. Van Wyk,
133: `The \-mpm Macro Package',
134: this manual, Volume\ 2
135: .SH BUGS
136: These features of
137: .B -ms
138: are missing:
139: .PD0
140: .IP
141: Document styles other than the default
142: .BR .RP .
143: .br
144: Space between front matter and first paragraph.
145: Recover it with
146: .BR ".SP 2" .
147: .br
148: Separating rule above footnotes.
149: .br
150: Keeps assigned to a separate page.
151: .br
152: Pages with more than two columns.
153: .LP
154: .I Troff
155: option
156: .B -o
157: doesn't work with
158: .BR -mpm
159: because only the postprocessor knows the page numbers.
160: .PD
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.