MM(1)

NAME
mm - prints documents formatted with the MM macros

SYNOPSIS
mm [ options []] [ files []]

DESCRIPTION
Use mm to format documents using nroff and the MM text-formatting macro package. mm has options to specify preprocessing by tbl and/or neqn, 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 that you select.

Options for mm are given below. Any other arguments or flags (e.g., [-rC3 )] are passed to nroff as appropriate. You may use such options in any order, but you must put them before the files arguments. If you do not specify arguments, mm prints a list of its options.

[-T type]
specifies the type of output terminal.
    Here is a list of recognized values for type.

    prepares output for a DASI 450 (default for mm) prepares output for a DASI 450 in 12-pitch mode. prepares output for a DASI 300 terminal. prepares output for a DASI 300 in 12-pitch mode. prepares output for a DASI 300S. prepares output for a DASI 300S in 12-pitch mode. prepares output for a TELETYPE Model 37 (default for nroff). prepares output for a DTC-382. prepares output for a TRENDATA 4000A. prepares output for a Hewlett-Packard HP262x or HP264x (implies [-c );] also equivalent to [-T2621 ,] [-T2640 ,] and [-T2645 .] prepares output for a HP2631 printer (implies [-c ).] same as [-T2631 ,] but in expanded mode. same as [-T2631 ,] but in compressed mode. prepares output for an Anderson Jacobson 832 printer (implies [-c ).] prepares output for a C.Itoh printer (implies [-c ).] prepares output for a Terminet 300 printer (implies [-c ).] prepares output for a device with no reverse or partial line motions or other special features (implies [-c ).] If you do not use this option, mm uses the value of the shell variable from the environment (see profile(4) and environ(5)) as the value of type if is set; otherwise, mm uses 450 as the value of type . If you specify several terminal types, the last one takes precedence.

    Note: To generate output on a Xerox page printer, use the mmx command.

    [-12]
indicates that the document is to be produced in 12-pitch.
    You may use this option when is set to one of 300, 300s, and 450. (You must manually set the pitch switch on the DASI 300 and 300s terminals to ``12'' if you use this option.)
    [-c]
causes
    mm to invoke col(1); note that col is invoked automatically by mm unless type is one of 300, 300s, 450, 37, 4000a, 382, and X.
    [-e]
causes
    mm to invoke neqn; also causes neqn(1) to read the file (see eqnchar(5)).
    [-t]
causes
    mm to invoke tbl(1).
    [-E]
invokes the
    [-e] option of nroff.

EXAMPLES
Assume that the shell variable is set in the environment to 450. These two command lines are then equivalent:
    mm -t -rC3 -12  files

    tbl  files | nroff -mm -T450-12 -h -rC3
mm reads the standard input when you specify [-] instead of any file names. (Mentioning other files together with [-] leads to undesired results.) This option allows you to use mm as a filter, for example:
    cat  files | mm -

HINTS

mm invokes nroff with the [-h] flag. With this flag, nroff assumes that the terminal has tabs set every 8 character positions.

Use the [-o list] option of nroff to specify ranges of pages to be output. Note, however, that if you invoke mm with one or more of the [-e ,] [-t ,] and [-] options, together with the [-o list] option of nroff, you may cause a harmless ``broken pipe'' diagnostic if you do not specify the last page of the document in list.

If you use the [-s] option of nroff (to stop between pages of output), use linefeed (rather than return or newline) 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).

If you lie to mm about the kind of terminal its output will be printed on, you will get (often subtle) garbage; however, if you are redirecting output into a file, use the [-T37] option, and then use the appropriate terminal filter when you actually print that file.

DIAGNOSTICS
If none of the arguments is a readable file and you do not use mm as a filter.

SEE ALSO
checkdoc(1), mmt(1), nroff(1), tbl(1), neqn(1), eqnchar(5), mm(5), term(5)