summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/m-tx/prepmx.1
blob: 299591e2e9d0d36b511ebc452b3587cb81a6c54a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
.TH prepmx 1 "01 September 2005" "M-Tx Version 0.60" "prepmx Manual Page"
.SH NAME
prepmx \- preprocessor for PMX, easy music typesetting program
.SH SYNOPSIS
.B prepmx
.RI [ options ]
.I jobname
.RI [ outdir/ ]
.RI [ stylefile ]
.SH DESCRIPTION
.B M-Tx
is an easy to use preprocessor language for the
.B PMX
music typesetting program, aimed at people who are not experts.  For an
easy example, have a look at the following example:

  c2+       e4    g   | b4d-  c1 d c2        |
  c8 g+ e g c- g+ e g | d g f g    c- g+ e g |

For syntax reference, please look at the M-Tx manual written by Dirk
Laurie, the creator of the M-Tx language and the author of prepmx, its
command line utility.

.B prepmx
processes the file
.IR jobname .mtx
to generate
.IR jobname .pmx.
You can then process this file using the `pmx' command.
.B PMX
is a preprocessor for MusiXTeX.

.I outdir/
is the directory where `pmx' will put the final .tex file. Note that the
trailing slash is mandatory. You can provide a
.I stylefile
for M-Tx. If omitted, the file `mtxstyle.txt' in the current
directory is used, if there is one.
.SH OPTIONS
Options can also be specified in a `Options:' line in the preamble,
which takes precedence over the command line.
.TP
.B \-b
never unbeam eighth notes and shorter
.TP
.B \-c
main music lines only \- ignore chords
.TP
.B \-D
enable debug mode
.TP
.B \-f
use tonic sol\-fa note names
.TP
.B \-i
ignore errors
.TP
.B \-m
music only \- ignore lyrics
.TP
.B \-n
indent first system and print default instrument names
.TP
.B \-t
ignore uptext lines
.TP
.B \-u
uptext synchronizes with notes only, not rests
.TP
.B \-v
verbose progress report
.TP
.B \-w
enable pedantic warnings
.TP
.BI \- n
select specified case of multiple score
.SH EXIT STATUS
If no error was found,
.B prepmx
exits with return code 0.  In case of an error, the line number of the
processed line is returned. This may not always be the line containing
the actual error. A return status of 10000 means that the input file was
empty or could not be opened.
.SH SEE ALSO
.B M-Tx
User's Guide (mtx060.pdf)
.br
pmx(1), musixtex(1)
.SH AUTHORS
prepmx was written by Dirk Laurie <dpl@sun.ac.za>.
This manual page was written by Roland Stigge <stigge@antcom.de> for the Debian
project. It was revised and extended by Nis Martensen
<nis.martensen@web.de>, mostly by copying text from Dirk Laurie's M-Tx
User's Guide.