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 ] } ...

DESCRIPTION

       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 .ltx extension, the file is processed using latex(1) (or pdflatex(1)) in
       place of etex.

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

       If  a  jobname  argument  has  none  of  these extensions, 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        assume LaTeX source; implied if the file has .ltx extension

       -p        change the TeX processor to pdfetex(1) or pdflatex(1) (and doesn't run a dvi processor)

       -c        preprocess pmx file using pmxchords(1)

       -d        don't generate a .ps file and change the dvi processor to dvipdfm(1)

       -D dvix   use dvix as the dvi processor; e.g., -D "dvipdfm -m 0.9".  Use -d before  -D  to  suppress  .ps
                 generation.

       -P ps2pdf use ps2pdf as the Postscript processor; e.g., -P "ps2pdf -sPAPERSIZE=a4"

       -F fmt    use fmt as the TeX processor; e.g., -F "luatex --output-format=dvi"

       -m        stop processing at the pmx file

       -M mtxx   use mtxx as the mtx preprocessor; e.g., -M "prepmx -i".

       -A aspcx  use aspcx as the aspc preprocessor; e.g., -A "autosp -l".

       -t        stop processing at the tex/mid files

       -s        stop processing at the dvi file

       -g        stop 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.  Version information is copied from the temporary file to the log file.

       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

       If the -F option is used, options -l and -p need to be set if the engine name does  not  contain  "latex"
       and "pdf" respectively. For example, the above four engines can be replaced by:
         -F "luatex --output-format=dvi"
         -F "lualatex --output-format=dvi"
         -F "luatex" -p
         -F "lualatex" -p

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>.