summaryrefslogtreecommitdiff
path: root/obsolete/support/abcwin
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /obsolete/support/abcwin
Initial commit
Diffstat (limited to 'obsolete/support/abcwin')
-rw-r--r--obsolete/support/abcwin/read1st.txt135
1 files changed, 135 insertions, 0 deletions
diff --git a/obsolete/support/abcwin/read1st.txt b/obsolete/support/abcwin/read1st.txt
new file mode 100644
index 0000000000..fb17bb96e1
--- /dev/null
+++ b/obsolete/support/abcwin/read1st.txt
@@ -0,0 +1,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