1MUSIXTEX(1) MUSIXTEX(1)
2
3
4
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
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
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
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
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)