                   M-Tx Documentation Package

This is the development version of the M-Tx documentation.  It contains
all the sources for generating the Users's Manual (mtxdoc.?), its index
(mtxindex.?), and two sample music documents (halleluja.?, kanons.?), where
'?' might be 'dvi', 'ps', 'pdf' or 'lj'.  

On a GNU system (e.g. Linux; or Cygwin running under Windows) you need
to change to some empty directory and unzip a file with a name of the
form mtxD????.zip (use GNU unzip with the -a option, or some other
unzipper that can convert text files to your operating system format).
You need to have MusiXTEX, PMX, musixlyr and M-Tx already installed.

Now decide whether you will need:
 .ps, .pdf, .dvi or .lj files (go to 1); 
 only .ps or .pdf files (goto 2).


                1. If you want .dvi or .lj files

This option allows you to make any of the four file formats.  Type

  make dvitarget && make config

to configure the option.  Make sure that everything looked for was found.
You can then choose between:

  make	      Makes mtx.dvi (and mtxdoc.dvi, mtxindex.dvi on the way there)
  make all    Make .dvi files.  
  make ps     Make .dvi and .ps files
  make pdf    Make .dvi, .ps and .pdf files
  make ?.lj   Make the specified .lj file


                2. If you want only .ps or .pdf files

You need to have pdflatex installed (any good TeX distribution has it). Type

  make pdftarget && make config

to configure the option.  Make sure that everything looked for was found.
You can then choose between:

  make	      Makes mtx.pdf (and mtxdoc.pdf, mtxindex.pdf on the way there)
  make all    Make .pdf files.  
  make ps     Make .pdf and .ps files
 
You don't have the option of making .dvi or .lj files.


Dirk Laurie  <dlaurie@na-net.ornl.gov> 


FAQ - Frequently Asked Questions 

1. I get "make: ./prepmx: Command not found".

   A: You have omitted the "make config" step.

2. I have configured, but the make still fails.

   A: Look at the screen output from "make config".  Make sure that
      there is a file name after each "...".

3. Is there any difference between the .pdf and .ps files made by the
   two options?

   A: Yes.  If you go by the second route, slurs tend to look smoother
      and certain additional slur shapes are possible; see the PMX manual.
      Also, the two versions look a little different on a low-resolution 
      monitor, but apart from slurs, should be virtually indistinguishable
      when printed.

