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

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 .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

OPTIONS

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

SEE ALSO

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

AUTHOR

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)
Impressum