summaryrefslogtreecommitdiff
path: root/macros/musixtex/README
blob: 0d0ded9e0cbea8485f79e8336f069668c7d9f767 (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
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
This is MusiXTeX, version 1.35 (2021-08-29).
MusiXTeX is a TeX-based system for typesetting music.

The main author was Daniel Taupin, who died in a climbing
accident in 2003; other authors credited in the MusiXTeX
manual are Andreas Egler and Ross Mitchell. MusiXTeX is now
being maintained by

Don Simons dsimons(at)roadrunner(dot)com
Hiroaki Morimoto CQX05646(at)nifty(dot)com
Bob Tennent rdt(at)cs(dot)queensu(dot)ca

The package includes

   + Postscript slur support, due to Stanislav Kneifl

   + musixlyr support for lyrics, due to Rainer Dunker

   + musixcrd support for chord symbols, due to Robert Hennig

   + support for music text in Palatino, Helvetica, Times 
     and EC fonts

   + several other extension packages 

   + a script musixflx.lua for the 2nd-pass processing

   + a script musixtex.lua that uses pre-processors prepmx,
     pmxab or autosp, as necessary, and automates the 3-pass
     etex -> musixflx -> [pdf]etex process, possibly
     followed by calls to dvips and ps2pdf (or dvipdfm) to
     convert the output to Portable Document Format (PDF)

   + wrapper scripts musixflx.bat and musixtex.bat for use on Windows

MusiXTeX fonts, including both the original metafont sources
and Type 1 versions by Takanori Uchiyama are in a separate
musixtex-fonts package, which must be installed before using
the MusiXTeX macros.

musixtex-install.{pdf,tex} is a more-detailed version of the
following instructions:

To install (on TDS-compliant TeX systems):

 +  unzip mirror.ctan.org/install/macros/musixtex.tds.zip at the root of a
    texmf tree and, if necessary, update the filename database; 
    e.g., texhash texmf.

 +  update the font maps, for example, by executing 

      updmap-user -enable Map frenchtab.map
      updmap-user -enable Map MuseJazzText.map

 +  on Windows: move the scripts in Windows to a folder
    on the executable PATH (or add that folder to the PATH)

 +  on any Unix-like system: install symbolic links musixflx
    and musixtex in a directory on the executable PATH to
    scripts/musixtex/musixflx.lua and scripts/musixtex/musixtex.lua,
    respectively.

Documentation for MusiXTeX and friends is installed under 

doc/generic/musixtex

Documentation for the musixflx and musixtex scripts are in 

doc/generic/musixtex/scripts 

Many users, especially beginners, will find it easier to
use the PMX and M-Tx pre-processors, which accept a simpler
input language than MusiXTeX itself. Another pre-processor,
autosp, simplifies input to MusiXTeX by automatically
generating note-spacing commands. These pre-processor
packages may be found at CTAN under support. Additional
documentation, additional add-on packages, and many examples
of 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

MusiXTeX may be freely copied, duplicated and used in
conformance to the GNU General Public License (Version 2,
1991, see included file gpl.txt) or (at your option) any
later version.  

The font file frenchtab.pfb is derived from mscoreTab.ttf
by Maurizio M. Gavioli. It was obtained from

https://github.com/musescore/MuseScore/blob/master/fonts/

and is licensed under the SIL Open Font Licence, 
Version 1.1; the text may be found in the doc directory.

The font file MuseJazzText.pfb is derived from MuseJazzText.otf
by Torsten Hämmerle and Abraham Lee. It was obtained from

https://github.com/musescore/MuseScore/blob/master/fonts

and is licensed under the SIL Open Font Licence,  
Version 1.1; the text may be found in the doc directory.

This distribution is maintained by Bob Tennent
rdt(at)cs(dot)queensu(dot)ca.