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