mm(1)                                                                 mm(1)




 NAME    [Toc]    [Back]
      mm, osdd - print documents formatted with the mm macros

 SYNOPSIS    [Toc]    [Back]
      mm [options] [files]

      osdd [options] [files]

 DESCRIPTION    [Toc]    [Back]
      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.

    Options    [Toc]    [Back]
      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.

 DIAGNOSTICS    [Toc]    [Back]
      mm sends the message mm: no input file if none of the arguments is a



 Hewlett-Packard Company            - 1 -   HP-UX 11i Version 2: August 2003






 mm(1)                                                                 mm(1)




      readable file and mm is not used as a filter.

 EXAMPLES    [Toc]    [Back]
      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 -

    Hints    [Toc]    [Back]
      +  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
         file.

 SEE ALSO    [Toc]    [Back]
      col(1), env(1), nroff(1), tbl(1), profile(4), term(4), mm(5).


 Hewlett-Packard Company            - 2 -   HP-UX 11i Version 2: August 2003