summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/man/man1/prepmx.1
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf/doc/man/man1/prepmx.1')
-rw-r--r--Master/texmf/doc/man/man1/prepmx.195
1 files changed, 95 insertions, 0 deletions
diff --git a/Master/texmf/doc/man/man1/prepmx.1 b/Master/texmf/doc/man/man1/prepmx.1
new file mode 100644
index 00000000000..299591e2e9d
--- /dev/null
+++ b/Master/texmf/doc/man/man1/prepmx.1
@@ -0,0 +1,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.