summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/pmx/README
blob: 2ddd274b887fbc10695fbc20f477a2e18cc5ea7a (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
This is PMX, version 2.6.19 (Jan. 13th, 2013). PMX provides a preprocessor for MusiXTeX.

pmxab builds a TeX input file based on a .pmx input file in a much
simpler language, making most of the layout decisions by itself. It has
most of MusiXTeX's functionality, but it also permits in-line TeX to
give access to virtually all of MusiXTeX. For proof-listening, pmxab will
make a MIDI file of your score.

scor2prt is an auxiliary program that makes parts from a score.

pmx2pdf is a wrapper script that runs pmxab, all 3 passes of MusiXTeX,
and subsequent conversions to PDF.

The author of pmxab and scor2prt is Don Simons (dsimons@roadrunner.com).
The author of the pmxccn tutorial is Cornelius C. Noack.

This package consists of

  (i) pmx.tds.zip, which contains macros, documentation, and the
      pmx2pdf.lua script

 (ii) pmx-2.6.19.tar.gz, which contains the source code for 
      pmxab and scor2prt

(iii) directories Windows and OSX, which contain pre-compiled
      pmxab and scor2prt executables for those platforms, and,
      for Windows, a batch script for running pmx2pdf.lua

 (iv) pmx-install.{tex,pdf}, which is a more detailed version of the
      following instructions:

To install (on TDS-compliant TeX systems):

 +  unzip /install/support/pmx.tds.zip at the root of a texmf tree and,
    if necessary, update the filename database; e.g., texhash texmf.
    Documentation for PMX is installed under doc/generic/pmx.

 +  on Windows or OS-X: copy the executables appropriate for your
    platform to a folder on the executable PATH

 +  on any Unix-like system with gcc and standard development tools
    installed: unpack the pmx tarball (anywhere), move to the resulting
    pmx-2.6.19 directory and do

       ./configure
       make
       make install (as root)

 +  on any Unix-like system: install a symbolic link pmx2pdf in any
    directory on the executable PATH to scripts/pmx/pmx2pdf.lua

In this release of PMX, the original Fortran sources for pmxab and
scor2prt have been included but the C files actually used have been
obtained from these by the f2c translator. The source files for libf2c,
which is needed at link time, are also included.

Documentation for PMX is installed under 

doc/generic/pmx

Many examples of PMX and MusiXTeX typesetting may be found at the Werner
Icking Music Archive at

http://icking-music-archive.org/

Support for users of MusiXTeX and related software may be obtained via
the MusiXTeX mail list at

http://tug.org/mailman/listinfo/tex-music

PMX may be freely copied, duplicated and used in conformance to the GNU
General Public License (see included file COPYING). The libf2c source
files are governed by a Notice that allows copying, modification and
distribution.

This CTAN distribution is maintained by Bob Tennent (rdt@cs.queensu.ca).
Jan. 13th, 2013.