Annotation of researchv10dc/man/man6/mpm.6, revision 1.1.1.1

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

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.