musixtex(1)

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

NAME

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

SYNOPSIS

11       [  texlua  ] musixtex[.lua] { option | jobname [ .xml | .mtx  | .pmx  |
12       .aspc | .tex | .ltx ] } ...
13

DESCRIPTION

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 .xml extension, the file is  first  prepro‐
36       cessed  using  xml2pmx(1)  and  the resulting .pmx file is processed as
37       above.
38
39       If a jobname argument has a .mtx extension, the file is  first  prepro‐
40       cessed  using  prepmx(1)  and  the  resulting .pmx file is processed as
41       above.
42
43       If a jobname argument has a .ltx extension, the file is processed using
44       latex(1) (or pdflatex(1)) in place of etex.
45
46       If  a jobname argument has a .aspc extension, the file is first prepro‐
47       cessed using autosp(1) and the resulting .tex or .ltx file is processed
48       as above.
49
50       If  a  jobname  argument  has none of these extensions, the script will
51       look for a file jobname.xml  or  jobname.mtx  or  jobname.pmx  or  job‐
52       name.aspc  or jobname.tex or jobname.ltx, in that order, and process it
53       as above.
54

OPTIONS

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

AUTHOR

139       This manual page was written by Bob Tennent <rdt@cs.queensu.ca>.
140
141
142
143musixtex version 0.23             2020-05-21                       MUSIXTEX(1)

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

SEE ALSO

AUTHOR