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
15 If a jobname argument has a .tex extension, the default effect is to
16 process the file using
17
18 etex(1) (first pass)
19
20 musixflx(1) (second pass)
21
22 etex(1) (third pass)
23
24 dvips(1) (dvi to Postscript)
25
26 ps2pdf(1) (Postscript to Portable Document Format)
27
28 normally followed by removal of intermediate and log files. A log
29 musixtex.log is generated, even if other log files are removed.
30
31 If a jobname argument has a .pmx extension, the file is first prepro‐
32 cessed using pmxab(1) and the resulting .tex file is processed as
33 above.
34
35 If a jobname argument has a .mtx extension, the file is first prepro‐
36 cessed using prepmx(1) and the resulting .pmx file is processed as
37 above.
38
39 If a jobname argument has a .ltx extension, the file is processed using
40 latex(1) (or pdflatex(1)) in place of etex.
41
42 If a jobname argument has a .aspc extension, the file is first prepro‐
43 cessed using autosp(1) and the resulting .tex or .ltx file is processed
44 as above.
45
46 If a jobname argument has none of these extensions, the script will
47 look for a file jobname.mtx or jobname.pmx or jobname.aspc or job‐
48 name.tex or jobname.ltx, in that order, and process it as above.
49
51 -v output program name and version number, and quit
52
53 -h output usage summary and quit
54
55 -l assume LaTeX source; implied if the file has .ltx extension
56
57 -p change the TeX processor to pdfetex(1) or pdflatex(1) (and
58 doesn't run a dvi processor)
59
60 -c preprocess pmx file using pmxchords(1)
61
62 -d don't generate a .ps file and change the dvi processor to
63 dvipdfm(1)
64
65 -D dvix use dvix as the dvi processor; e.g., -D "dvipdfm -m 0.9".
66 Use -d before -D to suppress .ps generation.
67
68 -P ps2pdf use ps2pdf as the Postscript processor; e.g., -P "ps2pdf
69 -sPAPERSIZE=a4"
70
71 -F fmt use fmt as the TeX processor; e.g., -F "luatex --output-for‐
72 mat=dvi"
73
74 -m stop processing at the pmx file
75
76 -M mtxx use mtxx as the mtx preprocessor; e.g., -M "prepmx -i".
77
78 -A aspcx use aspcx as the aspc preprocessor; e.g., -A "autosp -l".
79
80
81 -t stop processing at the tex/mid files
82
83 -s stop processing at the dvi file
84
85 -g stop processing at the ps file
86
87 -i retain intermediate and log files
88
89 -1 one-pass [pdf][la]tex processing; i.e., without call‐
90 ing musixflx
91
92 -x call makeindex(1) to update index database
93
94 -f restore default processing
95
96 -q quiet mode (only musixtex's own messages); other mes‐
97 sages are diverted to a temporary file. If an error
98 occurs at the TeX stage, processing halts immediately
99 and the tail of the log file is sent to stderr. Ver‐
100 sion information is copied from the temporary file to
101 the log file.
102
103
104
105 Options affect processing of all succeeding MusiXTeX files
106 unless changed by another option. Option flags cannot be com‐
107 bined; e.g., use -l -x rather than -lx.
108
109 Note that four TeX engines are available via the -l and -p
110 options:
111
112 etex default
113 latex -l
114 pdfetex -p
115 pdflatex -l -p
116
117 If the -F option is used, options -l and -p need to be set if
118 the engine name does not contain "latex" and "pdf" respectively.
119 For example, the above four engines can be replaced by:
120 -F "luatex --output-format=dvi"
121 -F "lualatex --output-format=dvi"
122 -F "luatex" -p
123 -F "lualatex" -p
124
125
127 autosp(1), etex(1), latex(1), pdfetex(1), pdflatex(1), makein‐
128 dex(1), musixflx(1), dvipdfm(1), dvips(1), pmxab(1), pmx‐
129 chords(1) prepmx(1), ps2pdf(1) and musixdoc.pdf.
130
132 This manual page was written by Bob Tennent <rdt@cs.queensu.ca>.
133
134
135
136musixtex version 0.21 2018-07-27 MUSIXTEX(1)