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