------------------------------- Page    i -------------------------------

                       Formatting Memoranda on UTS

------------------------------- Page   ii -------------------------------

                            TABLE OF CONTENTS


Abstract  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   1

1.    Introduction  . . . . . . . . . . . . . . . . . . . . . . . . .   1

2.    Memorandum Heading  . . . . . . . . . . . . . . . . . . . . . .   2

3.    Memorandum Signature  . . . . . . . . . . . . . . . . . . . . .   3

4.    Page Header and Footer  . . . . . . . . . . . . . . . . . . . .   3

4.1      Three Part Titles  . . . . . . . . . . . . . . . . . . . . .   3

5.    The mm Command  . . . . . . . . . . . . . . . . . . . . . . . .   4

References  . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   5

Appendix A.    Memorandum Sample  . . . . . . . . . . . . . . . . . .   6

Appendix B.    Command Summary  . . . . . . . . . . . . . . . . . . .   8

                                                            Last Page 9




                             TABLE OF TABLES


Table 1.    ms Features Not Available With mm . . . . . . . . . . . .   1

Table 2.    mm Features Not Available With ms . . . . . . . . . . . .   2

-------------------------------- Page  1 --------------------------------

ABSTRACT

This document describes a text formatting package called mm available  on
UTS which  is  used  to  produce Amdahl  style  memoranda,  and  informal
unreleased documents.  An input file  is created containing the  commands
described in this  document and its  companion, "Formatting Documents  on
UTS" [1], and then formatted using the UTS command mm.  The mm command is
described in {#5}.




1.    INTRODUCTION

All commands that format  text in ms,  including section headings,  lists
and displays, are also included  in mm.  Appendix B is a command  summary
which lists  all the  mm  commands.  All  section numbers,  except  those
marked '(mm)', refer to sections in the ms user's guide [1].

Most of the commands in this package are the same as those in the ms text
formatting package.  Descriptions of  mm commands and features which  are
identical to those in  ms can be  found in [1].   Familiarity with ms  is
assumed in this document.  The discussion below describes the differences
between ms and mm.


              Table 1.    ms Features Not Available With mm

       |_________|__________|__________________________________|
       | options | commands |              features            |
       |_________|__________|__________________________________|
       |         |          | alternate format styles:         |
       |    -r   |    .re   |    preliminary or release        |
       |_________|____.cp___|____company_private_or_non-private|
       |         |  .mt .au | cover sheet                      |
       |    -i   |  .pr .op |                                  |
       |_________|____.rh___|_revision_history_page____________|
       |_________|____.tf___|_tables_of_Contents,_Figures,_etc.|
       |_________|____.pt___|_predefined_page_header_and_footer|

-------------------------------- Page  2 --------------------------------

              Table 2.    mm Features Not Available With ms
          _____________________________________________________
         |            |                                       |
         |__commands__|________________features_______________|
         |_.df_.da_.to|_______________________________________|
         | .fr .dx .su|  optional memorandum heading          |
         | .rf .d( .d)|                                       |
         |____________|_______________________________________|
         |_____.si____|__optional_memorandum_signature________|
         |_.ph_.pf_.tl|__user_definable_page_header_and_footer|




2.    MEMORANDUM HEADING

     .df day_file
     .da date
     .to receiver
     .fr sender
     .dx dept_ext
     .su subject
     .rf reference
     .d(
     .d)

Appendix A contains a memorandum produced by mm.  The memorandum  heading
is automatically generated  at the top of  page one if  any of the  above
memorandum heading commands were provided.  They may appear in any order,
but must  precede  any  memorandum  text.   Each  of  these  commands  is
optional.  If  the .da  command  is not  provided, the  current  date  is
assumed.

Each of these commands, except those for the distribution list, may  have
up to  9 words as  arguments.  More  words can be  provided by  enclosing
groups of words in double quotes.  Double quotes may appear in a memoran-
dum heading by using  '\(dq'.  Long items  may extend over several  input
lines by ending such lines  with a '\'.  Multiple  output lines for  each
item will be produced as needed.

Any number of names  may be included  in the distribution  list, one  per
line, between the .d( and .d) commands.  These names are  not enclosed in
quotes.

-------------------------------- Page  3 --------------------------------

3.    MEMORANDUM SIGNATURE

     .si [name]

This command  is used  for the  signature portion  of a  memorandum.   It
leaves six blank lines and then places name (up to 9 words which need not
be enclosed in double quotes)  at the left margin.   If name is  omitted,
the sender field of the .fr command is used for the signature.  Text or a
title on the lines after .si will be placed on the lines after the name.




4.    PAGE HEADER AND FOOTER

No automatic page header or  footer appears when using  mm, but the  user
can specify a header and/or footer as desired.  To do  this, macros ph or
pf may be defined, which will automatically  be invoked by mm to  produce
the desired page header  or footer, respectively.   These macros must  be
defined before any memorandum text, and should contain only .tl  commands
as described in the following  section.  If a memorandum heading is  gen-
erated on page 1, the user-specified page header will not appear on  that
page, but will be used on all other pages.

For example:

     .de ph
     .tl 'Bill Programmer''Sample Memorandum'
     ..
     .de pf
     .tl ''Page %''
     ..


4.1      THREE PART TITLES

     .tl 'left'center'right'

This command is used in the definition of a page header or footer  macro.
One line of  output is  produced, having three  fields.  The first  field
begins at the left margin, the next is  centered, and the third field  is
right adjusted.  The first  non-blank character following the .tl  (typi-
cally "'") is used to delimit the fields.  A '%' character in a field  is
output as the current page number.

-------------------------------- Page  4 --------------------------------

5.    THE MM COMMAND

Once the input is prepared, the document  can be formatted by giving  the
UTS command:

     mm [option ...] [file ...]

The following options are available:

[start_page]-[stop_page]   Only the selected pages  will be printed.   If
     start_page is omitted, 1  is assumed; and  if stop_page is  omitted,
     the last page is assumed.  Thus 5-8  prints only pages 5 through  8,
     5- starts with page 5, -8 stops with page 8, and - prints the entire
     document.  If a single page number appears with no dash at all, only
     that one page is printed.  Only one range of pages may be selected.

-c   The document is prepared for the COMp  80 and may be piped  directly
     into com(1).

-p[color][copies]   The document is printed by the TN printer.  The color
     may be either w or g, indicating white (9510) paper or regular green
     paper, respectively.  If color is  not specified, white is  assumed.
     If the number of copies desired is not specified, 1 is assumed.  The
     document is spooled  with the  user's standard  vm user  id and  bin
     number.  The status may be checked by logging on to VM and doing a q
     prt.  The spool file name used is that of the first file given.

-q[s][pitch]   The document is prepared  for the Qume  printer.  If s  is
     given the Qume stops  before printing each  page so that  individual
     sheets of paper can  be inserted.  Output  resumes when "RETURN"  is
     pressed.  The pitch can  be either 10 or  12, and defaults to 12  if
     not given.  This is the desired number of characters per  horizontal
     inch.

-D   Do not format the document or output anything, but display on  stan-
     dard error the command generated by mm.

The options may appear  in any order,  even after or  between the  files.
Only one -c, -p, or  -q option may be given.  If none of these is  speci-
fied, the document is formatted for a COI 3270 crt unless an stty memorex
has been done, in which case formatting is done for the Memorex 1377 crt.

The files contain  the document  text interspersed  with text  formatting
commands.  If multiple files are named they are treated as  one long file
to produce a single document.   If no files  are specified, mm  processes
its standard input, and thus may be used as a filter.

-------------------------------- Page  5 --------------------------------

REFERENCES

 [1]  Formatting Documents on UTS,

 [2]  Nroff User's Guide,

 [3]  Formatting Tables on UTS,

 [4]  Kernighan, B. W., M. E. Lesk, and J. F. Ossanna, Document  Prepara-
      tion, The Bell System Technical Journal, July-August 1978, Vol. 57,
      No. 6, Part 2, pp. 2115-2135.

-------------------------------- Page  6 --------------------------------

APPENDIX A.    MEMORANDUM SAMPLE

The input below will produce the memorandum seen on the following page.

     .fo @_
     .df 4241-001-80
     .to mm Users
     .fr Barry Bakalor
     .dx 4241/x8842
     .su "A new version of _mm_ has been installed on UTS" \
         "having several new features and extensions."
     .rf Formatting Memoranda on UTS
     .d(
     Evan Adams
     Susan Ellis
     Jeff Liotta
     Tom Lyon
     Adrienne Payne
     Casey Schaufler
     Dan Walsh
     Diane Warner
     Larry Whitlock
     .d)
     A new version of the _mm_ text formatting system has been installed.
     It contains all former features (with some minor modifications),
     plus many new features.
     It is compatible with the new _ms_,
     and has most of the new features provided there,
     including footnotes, tables, easy font changing, etc.
     .pp
     The _mm_ command has been changed significantly for compatibility
     with _ms_.
     Do a 'man mm' for details.
     The date command is now '.da' instead of '.cd'.
     The carbon copy list at the end of the memorandum has been replaced
     by a distribution list in the memorandum heading.
     Omitted entries in the heading will no longer appear,
     except for the date, which now defaults to the current date.
     Long entries in the heading may now extend across several lines.
     The '.mh' command is no longer necessary.
     The user may now define his own page footer as well as page header,
     although none is required.
     .pp
     Comments and suggestions are welcome.
     .si

-------------------------------- Page  7 --------------------------------


-------------------------------- Page  8 --------------------------------

APPENDIX B.    COMMAND SUMMARY

Section-  Command Syntax               Description

9.1.2.1   .al [type] [no_spaces]       begin automatically numbered list
6.2       .ap [appendix_name]          appendix title
9.1.1.1   .bl [no_spaces]              begin bullet list
7.2       .bq                          begin quoted paragraph
15.1      .br                          break line
15.10     .ce [n]                      center
15.12     .cu [n]                      continuously underline
2.(mm)    .d(                          'DISTRIBUTION:' list begin
2.(mm)    .d)                          'DISTRIBUTION:' list end
2.(mm)    .da date ...                 'DATE:' field
13.3      .de XX                       define macro
2.(mm)    .df day_file ...             day file number
9.1.1.2   .dl [no_spaces]              begin dash list
11.       .dp [type]                   begin display
13.2      .ds XX string                define string register
2.(mm)    .dx dept_ext ...             'DEPT/EXT NO:' field
11.       .ed                          end display
7.2       .eq                          end quoted paragraph
8.        .fe                          footnote end
12.1      .fg [title]                  figure title
15.2      .fi                          fill mode
14.2      .fo [bi]                     font change chars are b and i
2.(mm)    .fr sender ...               'FROM:' field
8.        .fs [label]                  footnote text start
14.2      .ft font                     change fonts
12.2      .gf label [title]            generalized figure title
6.1       .hd level [heading_name]     section heading
15.14     .hw word ...                 specify hyphenation points
9.1.1     .il label [no_spaces]        begin identically labeled list
15.8      .in [+n]                     indent
9.2       .le [label]                  list entry
9.4       .lx [no_space]               list exit
15.16     .mc [c]                      set margin character
15.6      .ne n                        need lines
15.3      .nf                          no fill mode
13.1      .nr XX +n                    define number register
9.1.2.2   .ol [no_spaces]              begin outline list
4.(mm)    .de pf {footer} ..           user definition of page footer
4.(mm)    .de ph {header} ..           user definition of page header
7.1       .pp                          begin paragraph
2.(mm)    .rf reference ...            'REFERENCE:' field
9.1.2.3   .rl [no_spaces]              begin reference list
15.5      .rs                          restore spacing
12.3      .sf XX                       save figure number
6.3       .sh XX                       save heading or appendix number
3.(mm)    .si [name]                   memorandum signature

-------------------------------- Page  9 --------------------------------

Section-  Command Syntax               Description

15.7      .sk [n]                      skip pages
9.3       .sl XX                       save list entry number
15.17     .so file                     include source file
15.4      .sp [n]                      space lines
2.(mm)    .su subject ...              'SUBJECT:' field
10.2      .t&                          table continuation
15.15     .ta position ...             tab setting
10.       .te                          table end
10.1      .th                          end of table heading
15.9      .ti +n                       temporary indent
4.1(mm)   .tl 'left'center'right'      three part title for header/footer
2.(mm)    .to receiver ...             'TO:' field
10.       .ts [h]                      table start
10.2      .t&                          table continuation
15.11     .ul [n]                      underline
15.13     .up [n]                      upper case
9.1.3     .vl [indent] [no_spaces]     begin variably labeled list




_______________
  -All section numbers, except those marked '(mm)', refer to sections  in
  the ms user's guide [1].
