xenial (1) musixtex.1.gz

Provided by: texlive-music_2015.20160320-1_all bug

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