~ubuntu-branches/ubuntu/raring/texlive-extra/raring

« back to all changes in this revision

Viewing changes to texmf/doc/man/man1/prepmx.1

  • Committer: Package Import Robot
  • Author(s): Norbert Preining
  • Date: 2012-05-16 08:22:07 UTC
  • mfrom: (1.1.12) (3.1.20 sid)
  • Revision ID: package-import@ubuntu.com-20120516082207-41ox35jj1qsu46a7
Tags: 2012.20120516-1
* new upstream snapshot based on TL2012 tlpretest
* switch to xz compression for orig and deb (Closes: #672428)

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH prepmx 1 "01 September 2005" "M-Tx Version 0.60" "prepmx Manual Page"
 
2
.SH NAME
 
3
prepmx \- preprocessor for PMX, easy music typesetting program
 
4
.SH SYNOPSIS
 
5
.B prepmx
 
6
.RI [ options ]
 
7
.I jobname
 
8
.RI [ outdir/ ]
 
9
.RI [ stylefile ]
 
10
.SH DESCRIPTION
 
11
.B M-Tx
 
12
is an easy to use preprocessor language for the
 
13
.B PMX
 
14
music typesetting program, aimed at people who are not experts.  For an
 
15
easy example, have a look at the following example:
 
16
 
 
17
  c2+       e4    g   | b4d-  c1 d c2        |
 
18
  c8 g+ e g c- g+ e g | d g f g    c- g+ e g |
 
19
 
 
20
For syntax reference, please look at the M-Tx manual written by Dirk
 
21
Laurie, the creator of the M-Tx language and the author of prepmx, its
 
22
command line utility.
 
23
 
 
24
.B prepmx
 
25
processes the file
 
26
.IR jobname .mtx
 
27
to generate
 
28
.IR jobname .pmx.
 
29
You can then process this file using the `pmx' command.
 
30
.B PMX
 
31
is a preprocessor for MusiXTeX.
 
32
 
 
33
.I outdir/
 
34
is the directory where `pmx' will put the final .tex file. Note that the
 
35
trailing slash is mandatory. You can provide a
 
36
.I stylefile
 
37
for M-Tx. If omitted, the file `mtxstyle.txt' in the current
 
38
directory is used, if there is one.
 
39
.SH OPTIONS
 
40
Options can also be specified in a `Options:' line in the preamble,
 
41
which takes precedence over the command line.
 
42
.TP
 
43
.B \-b
 
44
never unbeam eighth notes and shorter
 
45
.TP
 
46
.B \-c
 
47
main music lines only \- ignore chords
 
48
.TP
 
49
.B \-D
 
50
enable debug mode
 
51
.TP
 
52
.B \-f
 
53
use tonic sol\-fa note names
 
54
.TP
 
55
.B \-i
 
56
ignore errors
 
57
.TP
 
58
.B \-m
 
59
music only \- ignore lyrics
 
60
.TP
 
61
.B \-n
 
62
indent first system and print default instrument names
 
63
.TP
 
64
.B \-t
 
65
ignore uptext lines
 
66
.TP
 
67
.B \-u
 
68
uptext synchronizes with notes only, not rests
 
69
.TP
 
70
.B \-v
 
71
verbose progress report
 
72
.TP
 
73
.B \-w
 
74
enable pedantic warnings
 
75
.TP
 
76
.BI \- n
 
77
select specified case of multiple score
 
78
.SH EXIT STATUS
 
79
If no error was found,
 
80
.B prepmx
 
81
exits with return code 0.  In case of an error, the line number of the
 
82
processed line is returned. This may not always be the line containing
 
83
the actual error. A return status of 10000 means that the input file was
 
84
empty or could not be opened.
 
85
.SH SEE ALSO
 
86
.B M-Tx
 
87
User's Guide (mtx060.pdf)
 
88
.br
 
89
pmx(1), musixtex(1)
 
90
.SH AUTHORS
 
91
prepmx was written by Dirk Laurie <dpl@sun.ac.za>.
 
92
This manual page was written by Roland Stigge <stigge@antcom.de> for the Debian
 
93
project. It was revised and extended by Nis Martensen
 
94
<nis.martensen@web.de>, mostly by copying text from Dirk Laurie's M-Tx
 
95
User's Guide.