MM(1)                                                                    MM(1)


NAME
     mm - prints documents formatted with the mm macros

SYNOPSIS
     mm [ options ] [ file(s) ]

DESCRIPTION
     Use mm to format documents using nroff and the mm text-formatting macro
     package.  mm has options to specify preprocessing by tbl(1) 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 you select.

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

     -Ttty_type
              Specifies the type of output terminal.  Here is a list of
              recognized values for tty_type.
              2631 Hewlett-Packard 2631 printer in regular mode
              2631-c
                   Hewlett-Packard 2631 printer in compressed mode
              2631-e
                   Hewlett Packard 2631 printer in expanded mode
              300  DASI-300 printer
              300-12
                   DASI-300 terminal set to 12-pitch (12 characters per inch)
              300s DASI-300s printer (300S is a synonym)
              300s-12
                   DASI-300s printer set to 12-pitch (12 characters per inch)
                   (300S is a synonym)
              37   Teletype Model 37 terminal
              382  DTC-382
              4000a
                   Trendata 4000a terminal (4000A is a synonym)
              450  DASI-450 (Diablo Hyterm) printer
              450-12
                   DASI-450 terminal set to 12-pitch (12 characters per inch)
              832  Anderson Jacobson 832 terminal
              8510 C.ITOH printer
              tn300
                   GE Terminet 300 terminal
              X    printers equipped with TX print train
              lp   generic name for printers that can underline and tab.  lp
                   is the default device for mm.  All text sent to lp
                   requiring reverse linefeeds, such as those having tables,
                   must be processed with col, invoked with mm's -c option.
                   If you do not use this option, mm uses the value of the
                   shell variable $TERM from the environment (see profile(4)
                   and environ(5)) as the value of tty_type if $TERM is set;


                   otherwise, mm uses 450 as the value of tty_type.  If you
                   specify several terminal types, the last one takes
                   precedence.
                   -12      indicates that the document is to be produced in
                            12-pitch.  You may use this option when $TERM 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(1) is
                            invoked automatically by mm unless tty_type is one
                            of 300, 300s, 450, 37, 4000a, 382, and X.
                   -e       Causes mm to invoke neqn; also causes neqn to read
                            the /usr/pub/eqnchar file (see eqnchar(5)).
                   -t       Causes mm to invoke tbl(1).
                   -E       Invokes the -e option of nroff.

                   As an example (assuming that the shell variable $TERM is
                   set in the environment to 450), the two command lines below
                   are equivalent:

                        mm -t -rC3 -12  file(s)
                        tbl file(s) | nroff -mm -T450-12 -h -rC3

                   mm reads the standard input when you specify - instead of
                   any file(s).  (Mentioning other files together with - leads
                   to undesired results.)  This option allows you to use mm as
                   a filter, for example:

                        cat file(s) | mm -

HINTS
     1.   Mm invokes nroff with the -h flag.  With this flag, nroff assumes
          that the terminal has tabs set every 8 character positions.
     2.   Use the -olist 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 -olist option of nroff
          you may cause a harmless ``broken pipe'' diagnostic if you do not
          specify the last page of the document in list.
     3.   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(1) (see -c option above).
     4.   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.

FILES
     /usr/pub/terminal list of supported terminals


SEE ALSO
     checkmm(1), col(1), env(1), eqn(1), greek(1), mmt(1), mvt(1), neqn(1),
     nroff(1), tbl(1), profile(4), mm(5), term(5).
     The "mm: Technical Discussion"
     "The Macro Package mm" in the User's Guide.


                                                                        Page 3