musixtex - processes MusiXTeX files, using pre-processors prepmx,
xml2pmx, pmxab and autosp as necessary, and then deletes intermediate and
log files (unless -i is used)
[ texlua ] musixtex[.lua] { option | jobname
[ .xml | .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 .xml extension, the file is first
preprocessed using xml2pmx(1) and the resulting .pmx 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.xml or jobname.mtx or
jobname.pmx or jobname.aspc or jobname.tex or
jobname.ltx, in that order, and process it as above.
- -v, -version,
--version
- output program name and version number, and quit
- -h, -help, --help
- 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".
- -X pmxx
- use pmxx as the pmx preprocessor; e.g., -X
"./pmxab",
- -A aspcx
- use aspcx as the aspc preprocessor; e.g., -A "autosp
-l".
- -L xmlx
- use xmlx as the xml preprocessor; e.g., -L
"./XML2PMX".
- -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
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), xml2pmx(1)
and musixdoc.pdf.
This manual page was written by Bob Tennent
<rdt@cs.queensu.ca>.