mm, osdd - print documents formatted with the mm macros
mm [options] [files]
osdd [options] [files]
mm can be used to format and print documents using nroff and the mm
text-formatting macro package (see nroff(1)). It has options to
specify preprocessing by tbl and/or neqn, (see tbl(1) and neqn(1)),
and postprocessing by various terminal-oriented output filters. The
proper pipelines and the required arguments and flags for nroff and mm
are generated, depending on the options selected.
osdd is equivalent to the command mm -mosd.
mm recognizes the following options and command-line arguments. Any
other arguments or options (such as -rC3) are passed to nroff or to
mm, as appropriate. Such options can occur in any order, but they
must appear before the files arguments. If no arguments are given, mm
prints a list of its options.
-Tterm Specifies the type of output terminal; for a list of
recognized values for term, type help term2. If this
option is not used, mm uses the value of the shell
variable $TERM from the environment (see profile(4) and
environ(5)) as the value of term if $TERM is set;
otherwise, mm uses 450 as the value of term. If several
terminal types are specified, the last one is used.
-12 Indicates that the document is to be produced in 12-
pitch. Can be used when $TERM is set to one of 300,
300s, 450, and 1620. (The pitch switch on the DASI 300
and 300s terminals must be manually set to 12 if this
option is used.)
-c Causes mm to invoke col(1); note that col(1) is invoked
automatically by mm unless term is one of 300, 300s,
450, 37, 4000a, 382, 4014, tek, 1620, and X.
-e Causes mm to invoke neqn.
-t Causes mm to invoke tbl.
-E Invokes the -e option of nroff.
mm sends the message mm: no input file if none of the arguments is a
Hewlett-Packard Company - 1 - HP-UX Release 11i: November 2000
readable file and mm is not used as a filter.
Assuming that the shell variable $TERM is set in the environment to
450, the two command lines below are equivalent:
mm -t -rC3 -12 ghh*
tbl ghh* | nroff -cm -T450-12 -h -rC3
mm reads the standard input when - is specified instead of any file
names (mentioning other files along with - leads to disaster). This
option allows mm to be used as a filter, as in this example:
cat dws | mm -
+ mm invokes nroff with the -h option. With this option, nroff
assumes that the terminal has tabs set every 8 character positions.
+ Use the -olist option of nroff to specify ranges of pages to be
output. Note, however, that mm, if invoked with one or more of the
-e, -t, and - options, together with the -olist option of nroff may
cause a harmless ``broken pipe'' diagnostic if the last page of the
document is not specified in list.
+ If you use the -s option of nroff (to stop between pages of
output), use line-feed (rather than return or new-line) to restart
the output. The -s option of nroff does not work with the -c
option of mm, or if mm automatically invokes col (see -c option
above and col(1)).
+ If you specify an incorrect output terminal type, mm produces
(often subtle) unpredictable results. However, if you are
redirecting output into a file, use the -T37 option, then use the
appropriate terminal filter when actually printing the formatted
col(1), env(1), nroff(1), tbl(1), profile(4), term(4), mm(5).
mm section in Text Formatting: User's Guide.
Hewlett-Packard Company - 2 - HP-UX Release 11i: November 2000