                    The M-Tx User's Manual


The file mtxdoc.tex is a LaTeX document containing many examples
of music generated from .mtx files.  These examples were generated
as follows:

  1. Put each .mtx file through prepmx, pmxa and pmxb.
 
  2. Edit the resulting .tex file to an .ex file as follows:

     (a) Delete lines starting with the following `hit' strings:

         \immediate
         \let\:
         \nopagenumbers
         \input
         \readmod
         \vfill\eject
         \bye

     (b) Delete the following `cut' string where it appears at the
         start of a line: 

         \startmuflex  

     A Turbo Pascal program for doing the editing is included here.  
     I have checked that it compiles satisfactory on Linux via the 
     p2c converter (from the p2c-devel package) as follows:   

         p2c -LTurbo tex2ex.pas
         cc -lp2c tex2ex.c -o tex2ex 

     It is of course also very easy to do this editing with tools
     like sed or perl.  A Unix shell script tex2ex.sh to this purpose 
     is included in the distribution: see the comments at its head.

     The file mtxdoc.sty contains, among various macros, the necessary
     \input and other instructions to replace the deleted lines.
    

  3. To format the documentation for US letter size paper, create
     a file  mypaper.tex  containing the instruction
     
       \paperUS

     before issuing the preceding commands.  For A4 format, make
     sure that no such file exists, or that it does not contain
     the instruction \paperUS.

  4. Issue the following commands:

     latex mtxdoc
     musixflx mtxdoc
     makeindex mtxdoc (on MS-DOS systems the command is `makeindx')  
     latex mtxdoc

If you wish to make your own LaTeX files with M-Tx inserts, you
should put  \usepackage{mtxdoc}  in your preamble, and include
the inserts as follows:
  
     \begin{mus}
      \input MYINSERT.ex
     \end{mus}

Consult mtxdoc.tex for special effects such as making a music line
stick into the left margin.

To include the text of the .mtx file, use

     \verbatiminput{MYINSERT.mtx}

This requires the package verbatim.sty, available with all up-to-date
LaTeX2e installations.

In the case of some examples, the preamble is omitted.  The 
corresponding files have the extension .mtb.  These files are also 
automatically generated from the .mtx source.

