MUSIXTEX(1) MUSIXTEX(1)
NAME
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)
SYNOPSIS
[ texlua ] musixtex[.lua] { option | jobname [ .xml | .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 prepro-
cessed using pmxab(1) and the resulting .tex file is processed as
above.
If a jobname argument has a .xml extension, the file is first prepro-
cessed using xml2pmx(1) and the resulting .pmx file is processed as
above.
If a jobname argument has a .mtx extension, the file is first prepro-
cessed 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 prepro-
cessed 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 job-
name.aspc or jobname.tex or jobname.ltx, in that order, and process it
as above.
OPTIONS
-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-for-
mat=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 en-
gine 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), xml2pmx(1) and musixdoc.pdf.
AUTHOR
This manual page was written by Bob Tennent <rdt@cs.queensu.ca>.
musixtex version 0.23 2020-05-21 MUSIXTEX(1)
Generated by dwww version 1.14 on Sat Jun 13 11:06:25 CEST 2026.