unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 mm(1)								       mm(1)




 NAME
      mm, osdd - print documents formatted with the mm macros

 SYNOPSIS
      mm [options] [files]

      osdd [options] [files]

 DESCRIPTION
      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
      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
      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






 mm(1)								       mm(1)




      readable file and mm is not used as a filter.

 EXAMPLES
      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
      +	 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
      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