Annotation of researchv10dc/man/manw/mm.1, revision 1.1.1.1

1.1       root        1: .TH MM 1
                      2: .SH NAME
                      3: mm \- print out documents formatted with the \s-1MM\s+1 macros
                      4: .SH SYNOPSIS
                      5: .B mm
                      6: [ options ] [ files ]
                      7: .SH DESCRIPTION
                      8: .I Mm\^
                      9: can be used to type out documents using
                     10: .IR nroff (1)
                     11: and the
                     12: .SM MM
                     13: text-formatting macro package.
                     14: It has options to specify
                     15: preprocessing by
                     16: .IR tbl (1)
                     17: and/or
                     18: .IR neqn (1)
                     19: and postprocessing by various terminal-oriented output filters.
                     20: The proper pipelines and the
                     21: required arguments and flags for
                     22: .IR nroff (1)
                     23: and
                     24: .SM MM
                     25: are generated, depending on the options selected.
                     26: .PP
                     27: .I Options\^
                     28: for
                     29: .I mm\^
                     30: are given below.
                     31: Any other arguments or flags (e.g.,
                     32: .BR \-rC3 )
                     33: are passed
                     34: to
                     35: .IR nroff (1)
                     36: or to
                     37: .SM MM\*S,
                     38: as appropriate.
                     39: Such options can occur in any order,
                     40: but they must appear before the
                     41: .I files\^
                     42: arguments.
                     43: If no arguments are given,
                     44: .I mm\^
                     45: prints a list of its options.
                     46: .PP
                     47: .PD 0
                     48: .TP 9
                     49: .BI \-T term
                     50: Specifies the type of output terminal;
                     51: for a list of recognized values for
                     52: .IR term ,
                     53: type
                     54: .BR "help term2" .
                     55: If this option is
                     56: .I not\^
                     57: used,
                     58: .I mm\^
                     59: will use the value of the shell variable
                     60: .SM
                     61: .B $TERM
                     62: from the environment (see
                     63: .IR profile (5)
                     64: and
                     65: .IR environ (7))
                     66: as the value of
                     67: .IR term ,
                     68: if
                     69: .SM
                     70: .B $TERM
                     71: is set;
                     72: otherwise,
                     73: .I mm\^
                     74: will use
                     75: .B 450
                     76: as the value of
                     77: .IR term .
                     78: If several terminal types are specified,
                     79: the last one takes precedence.
                     80: .TP
                     81: .B \-12
                     82: Indicates that the document is to be produced in 12-pitch.
                     83: May be used when
                     84: .SM
                     85: .B $TERM
                     86: is set to one of
                     87: .BR 300 ,
                     88: .BR 300s ,
                     89: .BR 450 ,
                     90: and
                     91: .BR 1620 .
                     92: (The pitch switch on the
                     93: .SM DASI
                     94: 300 and 300s terminals must be manually
                     95: set to
                     96: .B 12
                     97: if this option is used.)
                     98: .TP
                     99: .B \-c
                    100: Causes
                    101: .I mm\^
                    102: to invoke
                    103: .IR col (1);
                    104: note that
                    105: .IR col (1)
                    106: is invoked automatically by
                    107: .I mm\^
                    108: unless
                    109: .I term\^
                    110: is one of
                    111: .BR 300 ,
                    112: .BR 300s ,
                    113: .BR 450 ,
                    114: .BR 37 ,
                    115: .BR 4000A ,
                    116: .BR 382 ,
                    117: .BR 4014 ,
                    118: .BR tek ,
                    119: .BR 1620 ,
                    120: and
                    121: .BR X .
                    122: .TP
                    123: .B \-e
                    124: Causes
                    125: .I mm\^
                    126: to invoke
                    127: .IR neqn (1);
                    128: also causes
                    129: .I neqn
                    130: to read the
                    131: .B /usr/pub/eqnchar
                    132: file (see
                    133: .IR eqnchar (7)).
                    134: .TP
                    135: .B \-t
                    136: Causes
                    137: .I mm\^
                    138: to invoke
                    139: .IR tbl (1).
                    140: .TP
                    141: .B \-E
                    142: Invokes the
                    143: .B \-e
                    144: option of
                    145: .IR nroff (1).
                    146: .TP
                    147: .B \-y
                    148: Causes
                    149: .I mm\^
                    150: to use the non-compacted version of the macros (see
                    151: .IR mm (7)).
                    152: .PD
                    153: .PP
                    154: As an example (assuming that the shell variable
                    155: .SM
                    156: .B $TERM
                    157: is set in the environment to
                    158: .BR 450 ),
                    159: the two command lines below are equivalent:
                    160: .RS
                    161: .PP
                    162: mm \|\-t \|\-rC3 \|\-12 \|ghh\(**
                    163: .br
                    164: tbl \|ghh\(** \|\(bv \|nroff \|\-cm \|\-T450\-12 \|\-h \|\-rC3
                    165: .RE
                    166: .PP
                    167: .I Mm\^
                    168: reads the standard input
                    169: when
                    170: .B \-
                    171: is specified
                    172: instead of any file names.
                    173: (Mentioning other files together with
                    174: .B \-
                    175: leads to disaster.)\ 
                    176: This option allows
                    177: .I mm\^
                    178: to be used as a filter, e.g.:
                    179: .RS
                    180: .PP
                    181: cat \|dws \|\(bv \|mm \|\-
                    182: .RE
                    183: .SH HINTS
                    184: .PD 0
                    185: .TP
                    186: 1.
                    187: .I Mm\^
                    188: invokes
                    189: .IR nroff (1)
                    190: with the
                    191: .B \-h
                    192: flag.
                    193: With this flag,
                    194: .IR nroff (1)
                    195: assumes that the terminal has tabs set
                    196: every 8 character positions.
                    197: .TP
                    198: 2.
                    199: Use the
                    200: .BI \-o list\^
                    201: option of
                    202: .IR nroff (1)
                    203: to specify ranges of pages to be output.
                    204: Note, however, that
                    205: .IR mm ,
                    206: if invoked with
                    207: one or more of the
                    208: .BR \-e ,
                    209: .BR \-t ,
                    210: and
                    211: .B \-
                    212: options,
                    213: .I together\^
                    214: with the
                    215: .BI \-o list\^
                    216: option of
                    217: .IR nroff (1)
                    218: may cause a harmless ``broken pipe'' diagnostic
                    219: if the last page of the document is not specified in
                    220: .IR list .
                    221: .TP
                    222: 3.
                    223: If you use the
                    224: .B \-s
                    225: option of
                    226: .IR nroff (1)
                    227: (to stop between pages of output),
                    228: use line-feed (rather than return or new-line)
                    229: to restart the output.
                    230: The
                    231: .B \-s
                    232: option of
                    233: .IR nroff (1)
                    234: does not work with the
                    235: .B \-c
                    236: option of
                    237: .IR mm ,
                    238: or if
                    239: .I mm\^
                    240: automatically invokes
                    241: .IR col (1)
                    242: (see
                    243: .B \-c
                    244: option above).
                    245: .TP
                    246: 4.
                    247: If you lie to
                    248: .I mm\^
                    249: about the kind of terminal its output will be printed on,
                    250: you'll get (often subtle) garbage;
                    251: however, if you are redirecting output into a file, use the
                    252: .B \-T37
                    253: option, and then use the appropriate terminal filter when you actually print that file.
                    254: .PD
                    255: .br
                    256: .ne 4
                    257: .SH SEE ALSO
                    258: .tr ~
                    259: .PD 0
                    260: col(1), env(1), eqn(1), greek(1), mmt(1), nroff(1), tbl(1),
                    261: profile(5), mm(7), term(7).
                    262: .PP
                    263: .I "\s-1MM\s+1\-Memorandum Macros\^"
                    264: by D.~W. Smith and J.~R. Mashey.
                    265: .PP
                    266: .I "Typing Documents with \s-1MM\s+1\|"
                    267: by D.~W. Smith and E.~M. Piskorik.
                    268: .PD
                    269: .SH DIAGNOSTICS
                    270: .tr ~~
                    271: ``mm: \|no input file''\| if
                    272: none of the arguments is a readable file and
                    273: .I mm\^
                    274: is not used as a filter.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.