mm(1) mm(1)
NAME
mm, osdd, checkmm - print/check documents formatted with the
mm macros
SYNOPSIS
mm [-Tterm] [-12] [-c] [-e] [-t] [-E] [-y] [files]
osdd [-Tterm] [-12] [-c] [-e] [-t] [-E] [-y] [files]
checkmm [files]
DESCRIPTION
mm can be used to generate documents using nroff and the mm
text-formatting macro package. It has flag options to
specify preprocessing by tbl(1) and/or neqn (see eqn(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 flag
options selected.
osdd is equivalent to the command mm -mosd. For more
information about the OSDD adapter macro package, see
mosd(5).
Options for mm are given below. Any other arguments or
flags (e.g., -rC3) are passed to nroff or to mm, as
appropriate. Such flag 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 flag options.
-Tterm Specifies the type of output terminal; for a list of
recognized values for term, type help term2. If
this flag option is not used, mm will use 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 will use 450 as
the value of term. If several terminal types are
specified, the last one takes precedence.
-12 Indicates that the document is to be produced in
12-pitch. May 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 set manually to
12 if this flag 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; also causes neqn to read
the /usr/pub/eqnchar file (see eqnchar(5)).
-t Causes mm to invoke tbl(1).
-E Invokes the -e flag option of nroff.
-y Causes mm to use the non-compacted version of the
Page 1 (last mod. 1/16/87)
mm(1) mm(1)
macros (see mm(5)).
checkmm is a program for checking the contents of the named
files for errors in the use of the Memorandum Macros,
missing or unbalanced neqn delimiters, and .EQ/.EN pairs.
The user need not use the checkeq program (see eqn(1)).
Appropriate messages are produced. The program skips all
directories, and if no filename is given, standard input is
read.
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 ghh*
tbl ghh* | nroff -cm -T450-12 -h -rC3
mm reads the standard input when - is specified instead of
any filenames. (Mentioning other files together with -
leads to disaster.) This flag option allows mm to be used as
a filter, e.g.:
cat dws | 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 flag 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 - flag options,
together with the -olist flag option of nroff may cause
a harmless broken pipe diagnostic if the last page of
the document is not specified in list.
3. If you use the -s flag option of nroff (to stop between
pages of output), use LINEFEED (rather than RETURN or
newline) to restart the output. The -s flag option of
nroff does not work with the -c flag option of mm, or if
mm automatically invokes col(1) (see -c flag 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 flag option, and then use the appropriate
terminal filter when you actually print that file.
FILES
/bin/mm
/usr/bin/checkmm
Page 2 (last mod. 1/16/87)
mm(1) mm(1)
/bin/osdd
SEE ALSO
col(1), env(1), eqn(1), greek(1), mmt(1), nroff(1), tbl(1),
profile(4), mm(5), mosd(5), ms(5), term(5),
``mm Reference Manual'' and ``Introduction to troff and mm''
in Oreo Text Processing Tools.
DIAGNOSTICS
mm ``mm: no input file'' if none of the arguments is a
readable file and mm is not used as a filter.
checkmm ``Cannot open filename'' if file(s) is unreadable.
The remaining output of the program is diagnostic
of the source file.
Page 3 (last mod. 1/16/87)