.TH MPM 6
.SH NAME
mpm, mspe \- macros for page makeup
.SH SYNOPSIS
.B troff -mpm
.I file ...
.PP
.B troff -mspe
.I file ...
.SH DESCRIPTION
These
.IR troff (1)
macros, largely compatible with
.IR ms (6),
make better pages.
They silently invoke and provide information to a
postprocessor that moves floating figures, avoids widows, and justifies
pages vertically by stretching vertical spaces that result from 
.BR .PP ,
.BR .LP ,
.BR .IP ,
.BR .QP ,
.BR .SH ,
.BR .NH ,
.BR .DS / .DE ,
.BR .EQ / .EN ,
.BR .TS / .TE ,
.BR .PS / .PE ,
.BR .P1 / .P2 ,
and
.BR .QS / .QE .
The packages support different styles:
.TF -mspe
.TP
-mpm
generic 
.TP
.B -mspe
.I Software\(emPractice and Experience
.PD
.PP
The following macros are different from or not part of
.BR -ms .
Values denoted
.I n
have default value
.BR 1v .
.TF xTmxtext
.TP
.BR .BP
Begin a new page.
.PD 0
.TP
.B .FL
Flush: force out previous keeps.
.TP
.B .FC
Finish a two-column region and start a new one.
.TP
.BI .KF \ m
Floating keep, with preferred center at vertical position
.IR m .
Special values
.L top
(default) and
.L bottom
are permitted.
.TP
.BI .NE \ n
Start new page if remaining vertical space on this page
is less than
.IR n .
.TP
.B .P1
Begin a program display (constant width font).
.TP
.B .P2
End a program display.
.TP
.BI .P3
Insert optional break point in program display.
.TP
.BI .SP " n " exactly
.br
.ns
.TP
.BI .SP " n " 
Insert vertical space of height
.IR n ,
stretchable unless
.B exactly
is present.
.TP
.BI .Tm " text"
Place page number and
.I text
on the standard error output.
.TP
.BI .X " text"
Present
.I text
to the hidden page-makeup program
as part of a device-dependent output sequence
.B x
.B X
.IR "text" .
Equivalent to
.BI \eX' text ' \f1.
.PD
.PP
Useful number registers:
.PD 0
.TP
.B HM
Header margin; default 1 inch.
.TP
.B FM
Footer margin; default 1 inch.
.TP
.B FO
Footer position; default 10 inches.
.TP
.B %#
Page number of current page.
.TP
.BR dP , dV
Shrinkage of point size and vertical spacing for
.BR .P1 ,
in points.
.PD
.PP
Useful strings:
.PD 0
.TP
.BR %e , %o
Even and odd page title commands, as
.BR .tl\ '''' .
.PD
.SH FILES
.B /sys/lib/tmac/tmac.pm
.br
.B /$cputype/bin/aux/pm
.SH SOURCE
.B /sys/src/cmd/pm
.SH "SEE ALSO"
.IR ms (6), 
.IR troff (1)
.br
B. W. Kernighan and C. J. Van Wyk,
``The \-mpm Macro Package'',
.I
Unix Research System Programmer's Manual,
Tenth Edition, Volume 2.
.SH BUGS
These features of
.B -ms
are missing:
.PD0
.IP
Document styles other than the default
.BR .RP .
.br
Space between front matter and first paragraph.
Recover it with
.BR ".SP 2" .
.br
Separating rule above footnotes.
.br
Keeps assigned to a separate page.
.br
Pages with more than two columns.
.LP
.I Troff
option
.B -o
doesn't work with
.BR -mpm 
because only the postprocessor knows the page numbers.
.PD