MV(5)                                                                    MV(5)


NAME
     mv - a troff macro package for typesetting view graphs and slides

SYNOPSIS
     mvt [ -a ] [ options ] [ files ]

     troff [ -a ] [ -rX1 ] -mv [ options ] [ files ]

DESCRIPTION
     This package makes it easy to typeset view graphs and projection slides
     in a variety of sizes.  A few macros (briefly described below) accomplish
     most of the formatting tasks needed in making transparencies.  All of the
     facilities of troff(1), cw(1), eqn(1), and tbl(1) are available for more
     difficult tasks.

     The output can be previewed on most terminals, and, in particular, on the
     Tektronix 4014, as well as on the Versatec printer.  For these two
     devices, specify the -rX1 option (this option is automatically specified
     by the mvt command-q.v.-when that command is invoked with the -T4014 or
     -Tvp options).  To preview output on other terminals, specify the -a
     option.

     The available macros are:

     .VS [n] [i] [d]      Foil-start macro; foil size is to be 7''x7''; n is
                          the foil number, i is the foil identification, d is
                          the date; the foil-start macro resets all parameters
                          (indent, point size, etc.)  to initial default
                          values, except for the values of i and d arguments
                          inherited from a previous foil-start macro; it also
                          invokes the .A macro (see below).

                          The naming convention for this and the following
                          eight macros is that the first character of the name
                          (V or S) distinguishes between view graphs and
                          slides, respectively, while the second character
                          indicates whether the foil is square (S), small wide
                          (w), small high (h), big wide (W), or big high (H).
                          Slides are ``skinnier'' than the corresponding view
                          graphs:  the ratio of the longer dimension to the
                          shorter one is larger for slides than for view
                          graphs.  As a result, slide foils can be used for
                          view graphs, but not vice versa; on the other hand,
                          view graphs can accommodate a bit more text.

     .Vw [n] [i] [d]      Same as .VS, except that foil size is 7'' wide x 5''
                          high.
     .Vh [n] [i] [d]      Same as .VS, except that foil size is 5''x7''.
     .VW [n] [i] [d]      Same as .VS, except that foil size is 7''x5.4''.
     .VH [n] [i] [d]      Same as .VS, except that foil size is 7''x9''.


     .Sw [n] [i] [d]      Same as .VS, except that foil size is 7''x5''.
     .Sh [n] [i] [d]      Same as .VS, except that foil size is 5''x7''.
     .SW [n] [i] [d]      Same as .VS, except that foil size is 7''x5.4''.
     .SH [n] [i] [d]      Same as .VS, except that foil size is 7''x9''.
     .A  [x]              Place text that follows at the first indentation
                          level (left margin); the presence of x suppresses
                          the 1/2 line spacing from the preceding text.
     .B  [m [s] ]         Place text that follows at the second indentation
                          level; text is preceded by a mark; m is the mark
                          (default is a large bullet); s is the increment or
                          decrement to the point size of the mark with respect
                          to the prevailing point size (default is 0); if s is
                          100, it causes the point size of the mark to be the
                          same as that of the default mark.
     .C  [m [s] ]         Same as .B, but for the third indentation level;
                          default mark is a dash.
     .D  [m [s] ]         Same as .B, but for the fourth indentation level;
                          default mark is a small bullet.
     .T  string           String is printed as an over-size, centered title.
     .I  [in] [a [x] ]    Change the current text indent (does not affect
                          titles); in is the indent (in inches unless
                          dimensioned, default is 0); if in is signed, it is
                          an increment or decrement; the presence of a invokes
                          the .A macro (see below) and passes x (if any) to
                          it.
     .S  [p] [l]          Set the point size and line length; p is the point
                          size (default is ``previous''); if p is 100, the
                          point size reverts to the initial default for the
                          current foil-start macro; if p is signed, it is an
                          increment or decrement (default is 18 for .VS, .VH,
                          and .SH, and 14 for the other foil-start macros); l
                          is the line length (in inches unless dimensioned;
                          default is 4.2'' for .Vh, 3.8'' for .Sh, 5'' for
                          .SH, and 6'' for the other foil-start macros).
     .DF n f [n f ...]    Define font positions; may not appear within a
                          foil's input text (i.e., it may only appear after
                          all the input text for a foil, but before the next
                          foil-start macro); n is the position of font f; up
                          to four ``n f'' pairs may be specified; the first
                          font named becomes the prevailing font; the initial
                          setting is (H is a synonym for G):
                                .DF  1  H  2  I  3  B  4  S
     .DV [a] [b] [c] [d]  Alter the vertical spacing between indentation
                          levels; a is the spacing for .A, b is for .B, c is
                          for .C, and d is for .D; all non-null arguments must
                          be dimensioned; null arguments leave the
                          corresponding spacing unaffected; initial setting
                          is:
                                .DV  .5v  .5v  .5v  0v
     .U  str1 [str2]      Underline str1 and concatenate str2 (if any) to it.


     The last four macros in the above list do not cause a break; the .I macro
     causes a break only if it is invoked with more than one argument; all the
     other macros cause a break.

     The macro package also recognizes the following upper-case synonyms for
     the corresponding lower-case troff requests:
       .AD  .BR  .CE  .FI  .HY  .NA  .NF  .NH  .NX  .SO  .SP  .TA  .TI

     The Tm string produces the trademark symbol.

     The input tilde (~) character is translated into a blank on output.

     See the user's manual cited below for further details.

FILES
     /usr/lib/tmac/tmac.v
     /usr/lib/macros/vmca

SEE ALSO
     eqn(1), mmt(1), tbl(1), troff(1).
     A Macro Package for View Graphs and Slides by T. A. Dolotta and
     D. W. Smith.

BUGS
     The .VW and .SW foils are meant to be 9'' wide by 7'' high, but because
     the typesetter paper is generally only 8'' wide, they are printed 7''
     wide by 5.4'' high and have to be enlarged by a factor of 9/7 before use
     as view graphs; this makes them less than totally useful.


                                                                        Page 3