1MUSIXTEX(1)                                                        MUSIXTEX(1)
2
3
4

NAME

6       musixtex - processes MusiXTeX files, using pre-processors prepmx, pmxab
7       and autosp as necessary, and then deletes intermediate  and  log  files
8       (unless -i is used)
9

SYNOPSIS

11       [  texlua ] musixtex[.lua] { option | jobname [ .mtx  | .pmx  | .aspc |
12       .tex | .ltx ] } ...
13
14       If a jobname argument has a .tex extension, the default  effect  is  to
15       process the file using
16
17       etex(1)     (first pass)
18
19       musixflx(1) (second pass)
20
21       etex(1)     (third pass)
22
23       dvips(1)    (dvi to Postscript)
24
25       ps2pdf(1)   (Postscript to Portable Document Format)
26
27       normally  followed  by  removal  of  intermediate and log files.  A log
28       musixtex.log is generated, even if other log files are removed.
29
30       If a jobname argument has a .pmx extension, the file is  first  prepro‐
31       cessed  using  pmxab(1)  and  the  resulting  .tex file is processed as
32       above.
33
34       If a jobname argument has a .mtx extension, the file is  first  prepro‐
35       cessed  using  prepmx(1)  and  the  resulting .pmx file is processed as
36       above.
37
38       If a jobname argument has a .ltx extension, the file is processed using
39       latex(1) (or pdflatex(1)) in place of etex.
40
41       If  a jobname argument has a .aspc extension, the file is first prepro‐
42       cessed using autosp(1) and the resulting .tex or .ltx file is processed
43       as above.
44
45       If  a  jobname  argument  has none of these extensions, the script will
46       look for a file jobname.mtx or  jobname.pmx  or  jobname.aspc  or  job‐
47       name.tex or jobname.ltx, in that order, and process it as above.
48

OPTIONS

50       -v        output program name and version number, and quit
51
52       -h        output usage summary and quit
53
54       -l        assume LaTeX source; implied if the file has .ltx extension
55
56       -p        change  the  TeX  processor to pdfetex(1) or pdflatex(1) (and
57                 doesn't run a dvi processor)
58
59       -c        preprocess pmx file using pmxchords(1)
60
61       -d        don't generate a .ps file and change  the  dvi  processor  to
62                 dvipdfm(1)
63
64       -D dvix   use  dvix  as  the  dvi processor; e.g., -D "dvipdfm -m 0.9".
65                 Use -d before -D to suppress .ps generation.
66
67       -F fmt    use fmt as the TeX processor; e.g., -F "luatex  --output-for‐
68                 mat=dvi"
69
70       -m        stop processing at the pmx file
71
72       -M mtxx   use mtxx as the mtx preprocessor; e.g., -M "prepmx -i".
73
74       -A aspcx  use aspcx as the aspc preprocessor; e.g., -A "autosp -l".
75
76
77       -t        stop processing at the tex/mid files
78
79       -s        stop processing at the dvi file
80
81       -g        stop processing at the ps file
82
83       -i        retain intermediate and log files
84
85       -1        one-pass  [pdf][la]tex processing; i.e., without call‐
86                 ing musixflx
87
88       -x        call makeindex(1) to update index database
89
90       -f        restore default processing
91
92       -q        quiet mode (only musixtex's own messages); other  mes‐
93                 sages  are  diverted to a temporary file.  If an error
94                 occurs at the TeX stage, processing halts  immediately
95                 and  the tail of the log file is sent to stderr.  Ver‐
96                 sion information is copied from the temporary file  to
97                 the log file.
98
99
100
101       Options  affect  processing  of  all  succeeding  MusiXTeX files
102       unless changed by another option.  Option flags cannot  be  com‐
103       bined; e.g., use  -l -x  rather than  -lx.
104
105       Note  that  four  TeX  engines  are  available via the -l and -p
106       options:
107
108           etex      default
109           latex     -l
110           pdfetex   -p
111           pdflatex  -l -p
112
113       If the -F option is used, options -l and -p need to  be  set  if
114       the engine name does not contain "latex" and "pdf" respectively.
115       For example, the above four engines can be replaced by:
116         -F "luatex --output-format=dvi"
117         -F "lualatex --output-format=dvi"
118         -F "luatex" -p
119         -F "lualatex" -p
120
121

SEE ALSO

123       autosp(1), etex(1), latex(1), pdfetex(1),  pdflatex(1),  makein‐
124       dex(1),   musixflx(1),   dvipdfm(1),  dvips(1),  pmxab(1),  pmx‐
125       chords(1) prepmx(1), ps2pdf(1) and musixdoc.pdf.
126

AUTHOR

128       This manual page was written by Bob Tennent <rdt@cs.queensu.ca>.
129
130
131
132musixtex version 0.19             2017-12-10                       MUSIXTEX(1)
Impressum