.\" This manpage is licensed under the GNU Public License
.TH MUSIXTEX 1 2016-06-06  "musixtex version 0.16" ""

.SH NAME
musixtex \- processes MusiXTeX files, using pre-processors prepmx, pmxab and autosp as necessary, 
and then deletes intermediate and log files (unless 
.B -i 
is used)
.SH SYNOPSIS
[ texlua ]
.B musixtex[.lua]
{
.I option 
| 
.I jobname 
[ .mtx  | .pmx  | .aspc | .tex | .ltx ] } ...
.TP 
If a jobname argument has a .tex extension, the default effect is to process the file using
.TP 12
.BR etex (1)
(first pass)
.TP
.BR musixflx (1)
(second pass)
.TP
.BR etex (1)
(third pass)
.TP
.BR dvips (1)
(dvi to Postscript)
.TP
.BR ps2pdf (1)
(Postscript to Portable Document Format)
.TP
normally followed by removal of intermediate and log files.  A log musixtex.log is generated, even if other log files are removed.
.P 
If a jobname argument has a .pmx extension, the file is first preprocessed using
.BR pmxab (1) 
and the resulting .tex file is processed as above.
.P
If a jobname argument has a .mtx extension, the file is first preprocessed using
.BR prepmx (1)
and the resulting .pmx file is processed as above.
.P
If a jobname argument has a .aspc extension, the file is first preprocessed using
.BR autosp (1) 
and the resulting .tex file is processed as above.
.P
If a jobname argument has a .ltx extension, the file is processed using
.BR latex (1)
(or
.BR pdflatex (1)).
.P
If a jobname argument has no extension, the script will look for a file 
.IR jobname .mtx
or
.IR jobname .pmx
or
.IR jobname .aspc
or
.IR jobname .tex
or
.IR jobname .ltx ,
in that order, and process it as above.
.SH OPTIONS
.TP 8
.B -v 
output program name and version number, and quit
.TP
.B -h
output usage summary and quit
.TP
.B -l 
assumes LaTeX source;
implied if the file has .ltx extension
.TP
.B -p 
changes the TeX processor to 
.BR pdfetex (1) 
or
.BR pdflatex (1)
(and doesn't run 
.BR dvips (1)
and 
.BR ps2pdf (1)
or
.BR dvipdfm (1)
)
.TP
.B -c
preprocess pmx file using 
.BR pmxchords (1)
.TP
.B -d 
changes the dvi processor to
.BR dvipdfm (1)
.TP 
.B -F fmt
uses 
.B fmt
as the TeX processor; e.g., -F "luatex --output-format=dvi"
.TP
.B -m
stops processing at the pmx file
.TP
.B -t
stops processing at the tex/mid files
.TP
.B -s 
stops processing at the dvi file
.TP
.B -g
stops processing at the ps file
.TP 
.B -i
retain intermediate and log files
.TP
.B -1
one-pass [pdf][la]tex processing; i.e., without calling 
.B musixflx
.TP
.B -x
call 
.BR makeindex (1)
to update index database
.TP
.B -f
restore default processing 
.TP
.B -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.


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

Note that four TeX engines are available via the -l and -p options:
.TP
    etex      default
    latex     -l
    pdfetex   -p
    pdflatex  -l -p
.TP 0
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

.SH SEE ALSO
.BR autosp (1),
.BR etex (1),
.BR latex (1),
.BR pdfetex (1),
.BR pdflatex (1),
.BR makeindex (1),
.BR musixflx (1),
.BR dvipdfm (1),
.BR dvips (1),
.BR pmxab (1),
.BR pmxchords (1)
.BR prepmx (1),
.BR ps2pdf (1)
and musixdoc.pdf.
.SH AUTHOR 
This manual page was written by Bob Tennent <rdt@cs.queensu.ca>.