NAME

       musixtex  -  processes  MusiXTeX  files,  using pre-processors prepmx, pmxab and autosp as
       necessary, and then deletes intermediate and log files (unless -i is used)

SYNOPSIS

       [ texlua ] musixtex[.lua] { option | jobname [ .mtx  | .pmx  | .aspc | .tex | .ltx ] } ...

       If a jobname argument has a .tex extension, the default effect  is  to  process  the  file
       using

       etex(1)     (first pass)

       musixflx(1) (second pass)

       etex(1)     (third pass)

       dvips(1)    (dvi to Postscript)

       ps2pdf(1)   (Postscript to Portable Document Format)

       normally  followed  by  removal  of  intermediate  and  log  files.  A log musixtex.log is
       generated, even if other log files are removed.

       If a jobname argument has a .pmx extension, the file is first preprocessed using  pmxab(1)
       and the resulting .tex file is processed as above.

       If a jobname argument has a .mtx extension, the file is first preprocessed using prepmx(1)
       and the resulting .pmx file is processed as above.

       If a jobname argument has  a  .aspc  extension,  the  file  is  first  preprocessed  using
       autosp(1) and the resulting .tex file is processed as above.

       If  a  jobname  argument  has  a  .ltx extension, the file is processed using latex(1) (or
       pdflatex(1)).

       If a jobname argument has no extension, the script will look for  a  file  jobname.mtx  or
       jobname.pmx  or  jobname.aspc or jobname.tex or jobname.ltx, in that order, and process it
       as above.

OPTIONS

       -v      output program name and version number, and quit

       -h      output usage summary and quit

       -l      assumes LaTeX source; implied if the file has .ltx extension

       -p      changes the TeX processor to pdfetex(1) or pdflatex(1) (and doesn't  run  dvips(1)
               and ps2pdf(1) or dvipdfm(1) )

       -c      preprocess pmx file using pmxchords(1)

       -d      changes the dvi processor to dvipdfm(1)

       -F fmt  uses fmt as the TeX processor

       -m      stops processing at the pmx file

       -t      stops processing at the tex/mid files

       -s      stops processing at the dvi file

       -g      stops processing at the ps file

       -i      retain intermediate and log files

       -1      one-pass [pdf][la]tex processing; i.e., without calling musixflx

       -x      call makeindex(1) to update index database

       -f      restore default processing

       -q      quiet  mode  (only  musixtex's  own  messages);  other  messages are diverted to a
               temporary file.  If an error occurs at the TeX stage, processing halts immediately
               and the tail of the log file is sent to stderr.

       Options  affect  processing  of  all  succeeding  MusiXTeX files unless changed by another
       option.  Option flags cannot be combined; e.g., use  -l -x  rather than  -lx.

       Note that four TeX engines are available via the -l and -p options:

           etex      default
           latex     -l
           pdfetex   -p
           pdflatex  -l -p

       The -F option allows any engine to be named. In that case, an attempt is  made  to  deduce
       implied  -l  and -p settings from the presence or absence of the strings 'latex' and 'pdf'
       in the name of the engine. If this is not correct, the user should explicitly specify  the
       appropriate option.

SEE ALSO

       autosp(1),   etex(1),   latex(1),   pdfetex(1),  pdflatex(1),  makeindex(1),  musixflx(1),
       dvipdfm(1), dvips(1), pmxab(1), pmxchords(1) prepmx(1), ps2pdf(1) and musixdoc.pdf.

AUTHOR

       This manual page was written by Bob Tennent <rdt@cs.queensu.ca>.