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
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
|
ABCWIN Package
May 4, 1995
The files in this directory are an informal compilation of stripped-down
software that is intended for Windows users to take .abc music notation text
files and convert them to viewable and printable music notation.
WARNING: Setting this up requires familiarity with a number of aspects
of MSDOS. A Windows-only user will most likely get lost doing this. This
is not a user-friendly setup process. Anyone who can contribute better
installation instructions is heartily welcome.
All enclosed software was written by other people, and credit is given in the
appropriate read-me files 00README.TXT (LaTex), SB39TEX.DOC (sbTeX),
SB39TM01.RME (big sbTeX for 386 machines), MUSICTEX.RME (MusicTex), and
README1.4 (ABC2MTEX). The reason this package was created was because the
process of setting all those packages up from scratch, including the obstacle
of required FTP access, was a major hindrance to wider usage of the abc
musical notation, especially centered around the exchanging of Irish dance
tunes on IRTRAD-L.
Necessary files: ------------------------------------
(if you're downloading this from celtic.stanford.edu, they're all in
\pub\tunes\abcwin)
(if you're downloading this from CTAN, you'll find dviwin29 under
\dviware\dviwin)
1. readme.1st (this file)
2. dviwin29.zip
3. abcwin.zip
4. { abcfonts.zip (if you have a 360-dots-per-inch printer)
{ (or)
{ not360.zip (fonts for other printer resolutions than 360 dpi).
5. pkz204g.exe (if you don't already have an unzipper of some kind)
------------------------------------
More fonts (and other optional TeX-related stuff) are available
via FTP from the CTAN archives:
(Texas) ftp.shsu.edu
(England) ftp.tex.ac.uk
(Germany) ftp.dante.de
If at some point you use TeX for something more ambitious than
just printing usrguide.tex and folk tunes, you'll run into all
sorts of file-not-found errors, but you can get the missing files at
the above sites. The Texas site has a search utility if you access
it via the Web: http://www.shsu.edu/cgi-bin/ctan-index
-------------------------------------
INSTALLATION
(If you don't have PKUNZIP, there's a copy of PKZ204G.EXE in \pub\tunes\abcwin,
and you just have to run it, i.e., issue the MSDOS command pkz204g, probably
within an empty directory that you've copied it to. Read the documentation.)
1) Begin with dviwin29.zip, unzip it in an empty directory and follow
the directions in README, especially parts 1 and 2.
2) Then unzip either abcfonts.zip or not360.zip, according to what
resolution printer you have. These PK fonts are necessary for, and
are explained in, DVI2WIN. You need to tell DVI2WIN where they are.
Now you can test the Windows part of all this. Test DVI2WIN with the test
document included with dviwin29.zip (you should get one page with an economics-
related graph and some text). Then test DVI2WIN with the file
\abcwin\abc2mtex\usrguide.dvi
If you get a blank screen or garbage then DVI2WIN didn't find the .pk fonts
which you unzipped in step 2 above. Fix this first (see the DVI2WIN docs).
3) Unzip abcwin in any empty directory and follow the directions in
ABC2DVI.TXT.
4) Then, after following all those directions (yes, it may take a while
to do everything), you should be able to issue the command
latex usrguide (from inside your new ABC2MTEX directory)
(do this twice, ignore all the complaints from TeX the first pass)
then in Windows, open DVI2WIN, and with that, open the file
usrguide.dvi that you just created. Read this, which is
Chris Walshaw's ABC2MTEX ver 1.4 manual, and try printing it.
This is also a good test that your whole setup is working.
WHAT'S WHERE
Inside \abcwin you should have:
..\bigfmt (2 format files necessary for TeX and laTeX to run)
..\abc2mtex (Chris Walshaw's ABC2MTEX v 1.4)
I also store all my abc tunes in this directory,
with suffix ".abc"
..\fonttfms (font files necessary for TeX to generate .dvi files)
..\inputs (TeX macro files called during .dvi generation)
Then in your \texfonts directory are all your .pk fonts divided up into
subdirectories named by their dpi resolutions.
EXAMPLE OF USAGE
You can now take, for example, emailed tunes like:
X:1
T:Off to California
M:4/4
R:hornpipe
E:7
K:G
(3DEF|GFGB AGED|GBdg e2 (3def|gfgd edBG|ABAG E2 (3DEF|GFGB AGED|\
GBdg e2 (3def|gfgd edBG|(3ABA GF G2::d|gfeg fedf|edef edB2|\
(3def gd edBG|ABAG E2 (3DEF|GFGB AGED|GBdg e2 (3def|gfgd edBG|(3ABA GF G3:|
cut and paste them into a text file, (try that with this example) run it
through ABC2MTEX and then TeX (see below) from within a DOS session under
Windows (you know, the big MS-DOS icon in the Main menu), jump over to
DVI2WIN and instantly (depending on the speed of your computer) see real
music! If you don't mind reading off of your screen, you have now eliminated
all paper from the process of receiving an email and learning the tune in it.
An example of the commands you would give using the above hornpipe, put in a
text file called EXAMPLE.ABC in the directory c:\abcwin\abc2mtex\, if you're
set up in drive C:, looks like this:
C:\ABCWIN\ABC2MTEX>abc2mtex m example
C:\ABCWIN\ABC2MTEX>tex music
That's it! Then, back in Windows, use DVI2WIN to open the file
"c:\abcwin\abc2mtex\music.dvi", which TeX just generated for you.
Alan Ng
agng@students.wisc.edu
Madison, WI
|