|
|
1.1 root 1: .TH MM 1
2: .SH NAME
3: mm \- print out documents formatted with the \s-1MM\s+1 macros
4: .SH SYNOPSIS
5: .B mm
6: [ options ] [ files ]
7: .SH DESCRIPTION
8: .I Mm\^
9: can be used to type out documents using
10: .IR nroff (1)
11: and the
12: .SM MM
13: text-formatting macro package.
14: It has options to specify
15: preprocessing by
16: .IR tbl (1)
17: and/or
18: .IR neqn (1)
19: and postprocessing by various terminal-oriented output filters.
20: The proper pipelines and the
21: required arguments and flags for
22: .IR nroff (1)
23: and
24: .SM MM
25: are generated, depending on the options selected.
26: .PP
27: .I Options\^
28: for
29: .I mm\^
30: are given below.
31: Any other arguments or flags (e.g.,
32: .BR \-rC3 )
33: are passed
34: to
35: .IR nroff (1)
36: or to
37: .SM MM\*S,
38: as appropriate.
39: Such options can occur in any order,
40: but they must appear before the
41: .I files\^
42: arguments.
43: If no arguments are given,
44: .I mm\^
45: prints a list of its options.
46: .PP
47: .PD 0
48: .TP 9
49: .BI \-T term
50: Specifies the type of output terminal;
51: for a list of recognized values for
52: .IR term ,
53: type
54: .BR "help term2" .
55: If this option is
56: .I not\^
57: used,
58: .I mm\^
59: will use the value of the shell variable
60: .SM
61: .B $TERM
62: from the environment (see
63: .IR profile (5)
64: and
65: .IR environ (7))
66: as the value of
67: .IR term ,
68: if
69: .SM
70: .B $TERM
71: is set;
72: otherwise,
73: .I mm\^
74: will use
75: .B 450
76: as the value of
77: .IR term .
78: If several terminal types are specified,
79: the last one takes precedence.
80: .TP
81: .B \-12
82: Indicates that the document is to be produced in 12-pitch.
83: May be used when
84: .SM
85: .B $TERM
86: is set to one of
87: .BR 300 ,
88: .BR 300s ,
89: .BR 450 ,
90: and
91: .BR 1620 .
92: (The pitch switch on the
93: .SM DASI
94: 300 and 300s terminals must be manually
95: set to
96: .B 12
97: if this option is used.)
98: .TP
99: .B \-c
100: Causes
101: .I mm\^
102: to invoke
103: .IR col (1);
104: note that
105: .IR col (1)
106: is invoked automatically by
107: .I mm\^
108: unless
109: .I term\^
110: is one of
111: .BR 300 ,
112: .BR 300s ,
113: .BR 450 ,
114: .BR 37 ,
115: .BR 4000A ,
116: .BR 382 ,
117: .BR 4014 ,
118: .BR tek ,
119: .BR 1620 ,
120: and
121: .BR X .
122: .TP
123: .B \-e
124: Causes
125: .I mm\^
126: to invoke
127: .IR neqn (1);
128: also causes
129: .I neqn
130: to read the
131: .B /usr/pub/eqnchar
132: file (see
133: .IR eqnchar (7)).
134: .TP
135: .B \-t
136: Causes
137: .I mm\^
138: to invoke
139: .IR tbl (1).
140: .TP
141: .B \-E
142: Invokes the
143: .B \-e
144: option of
145: .IR nroff (1).
146: .TP
147: .B \-y
148: Causes
149: .I mm\^
150: to use the non-compacted version of the macros (see
151: .IR mm (7)).
152: .PD
153: .PP
154: As an example (assuming that the shell variable
155: .SM
156: .B $TERM
157: is set in the environment to
158: .BR 450 ),
159: the two command lines below are equivalent:
160: .RS
161: .PP
162: mm \|\-t \|\-rC3 \|\-12 \|ghh\(**
163: .br
164: tbl \|ghh\(** \|\(bv \|nroff \|\-cm \|\-T450\-12 \|\-h \|\-rC3
165: .RE
166: .PP
167: .I Mm\^
168: reads the standard input
169: when
170: .B \-
171: is specified
172: instead of any file names.
173: (Mentioning other files together with
174: .B \-
175: leads to disaster.)\
176: This option allows
177: .I mm\^
178: to be used as a filter, e.g.:
179: .RS
180: .PP
181: cat \|dws \|\(bv \|mm \|\-
182: .RE
183: .SH HINTS
184: .PD 0
185: .TP
186: 1.
187: .I Mm\^
188: invokes
189: .IR nroff (1)
190: with the
191: .B \-h
192: flag.
193: With this flag,
194: .IR nroff (1)
195: assumes that the terminal has tabs set
196: every 8 character positions.
197: .TP
198: 2.
199: Use the
200: .BI \-o list\^
201: option of
202: .IR nroff (1)
203: to specify ranges of pages to be output.
204: Note, however, that
205: .IR mm ,
206: if invoked with
207: one or more of the
208: .BR \-e ,
209: .BR \-t ,
210: and
211: .B \-
212: options,
213: .I together\^
214: with the
215: .BI \-o list\^
216: option of
217: .IR nroff (1)
218: may cause a harmless ``broken pipe'' diagnostic
219: if the last page of the document is not specified in
220: .IR list .
221: .TP
222: 3.
223: If you use the
224: .B \-s
225: option of
226: .IR nroff (1)
227: (to stop between pages of output),
228: use line-feed (rather than return or new-line)
229: to restart the output.
230: The
231: .B \-s
232: option of
233: .IR nroff (1)
234: does not work with the
235: .B \-c
236: option of
237: .IR mm ,
238: or if
239: .I mm\^
240: automatically invokes
241: .IR col (1)
242: (see
243: .B \-c
244: option above).
245: .TP
246: 4.
247: If you lie to
248: .I mm\^
249: about the kind of terminal its output will be printed on,
250: you'll get (often subtle) garbage;
251: however, if you are redirecting output into a file, use the
252: .B \-T37
253: option, and then use the appropriate terminal filter when you actually print that file.
254: .PD
255: .br
256: .ne 4
257: .SH SEE ALSO
258: .tr ~
259: .PD 0
260: col(1), env(1), eqn(1), greek(1), mmt(1), nroff(1), tbl(1),
261: profile(5), mm(7), term(7).
262: .PP
263: .I "\s-1MM\s+1\-Memorandum Macros\^"
264: by D.~W. Smith and J.~R. Mashey.
265: .PP
266: .I "Typing Documents with \s-1MM\s+1\|"
267: by D.~W. Smith and E.~M. Piskorik.
268: .PD
269: .SH DIAGNOSTICS
270: .tr ~~
271: ``mm: \|no input file''\| if
272: none of the arguments is a readable file and
273: .I mm\^
274: is not used as a filter.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.