                                  ABCWIN.ZIP
                                March 25, 1995

Disclaimer: To quote one of the packages included in this package, "These
files are distributed in the hope that they will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE."

This is a totally unsupported, unsanctioned, jury-rigged collection
of stuff put out to satisfy immediate hunger for PC users to convert .abc 
files to .dvi files.  It arose out of the activity around the list IRTRAD-L 
and Chris Walshaw's ABC2MTEX package.  It is now part of the \pub\tunes\abcwin
collection kept at ftp://ceolas.stanford.edu.

Contents:       stripped-down sbTeX39tm01 (big version using GO32), 
                stripped-down MusicTeX ver 5.08
                stripped-down LaTex2E with 2.09 compatibility
                minimal font metric files (*.tfm)
                Minimal documentation for the above packages, mainly
                to give credit to the developers.
                ABC2MTEX ver 1.4, stripped to PC-necessary files

Requirements:   PC-compatible, 386 processor or better.  This TeX
                implementation can run in a DOS session under Windows,
                even with just 1 MB of extended memory allotted to it.
                The unzipped ABC2DVI.ZIP will take 1,783,756 bytes on your 
                hard drive. This was zipped with PKZIP 2.04g.

----------------------------------------------------------------------------

Installation directions:

Unzip ABCWIN.ZIP in a temporary directory, and you should now have 
this ABC2DVI.TXT file and a new zip file: ABC2DVI.ZIP.  You may have just 
done this step.

Go to the directory of the drive in which you would like to install it, 
e.g., C:\ABCWIN> (you may have to create it first), and unzip the ABC2DVI.ZIP 
file there.  Make  sure you use the -d option on pkunzip.  Like this:
C:\ABCWIN>pkunzip -d abc2dvi
The basic files will end up in ABCWIN, and others are put in subdirectories.

If you're not using the drive and the directory names I am, you'll have to 
edit the SETTEX.BAT file accordingly.  Punctuation is important.  Then, use 
any text editor (e.g., Notepad in Windows or EDIT in DOS) to put a line at or 
near the end of your AUTOEXEC.BAT file, reading: 
C:\ABCWIN\SETTEX.BAT
I also added "c:\abcwin" to my PATH statement in my AUTOEXEC.BAT.  Change your
own AUTOEXEC.BAT accordingly.

Reboot to get your AUTOEXEC settings updated.  Watch carefully for an error
message during the boot-up indicating that you're out of environment space.  
That means there were too many environment variables set in our SETTEX.BAT 
file.  If this occurs, edit your CONFIG.SYS file to increase the environment 
space.  This is done with the /e:xxx parameter.  My line in my CONFIG.SYS file 
looks like this:
SHELL=C:\DOS\COMMAND.COM C:\DOS\ /e:352 /p
where 352 is bigger than it was before, and an integer multiple of 32.

------------------------------------------------------------------------

How to use:

I assume you want to use Chris Walshaw's ABC2MTEX and DVI2WIN ver 2.81.
For your convenience, ABC2MTEX is included.  You should unzip DVI2WIN.ZIP
yourself and follow the enclosed directions.  Read READ1ST.TXT if you haven't
already.

Run ABC2MTEX to produce MUSIC.TEX (the default file name for output from 
ABC2MTEX). In other words:

C:\ABCWIN\ABC2MTEX\>abc2mtex m cheese

You should be able now (cross your fingers) to type:

tex music     (from within any directory, since we added \abcwin to the PATH
               environment variable).

and voila!, things run without errors and after a little wait, you end
up with a MUSIC.DVI file!  This one little step is the reason for this whole
package.

Another sample is \abcwin\inputs\jennyswe.tex.  Use the command "tex jennyswe".
Try opening the *.dvi output from these files with DVI2WIN.  Any file in the 
\abcwin\inputs directory or a subdirectory of that will be found by TeX when 
you run it, no matter what directory you may be in at the moment.  (You can
change this by changing the value of TEXINPUTS in our SETTEX.BAT file.  E.g.,
make it say: "TEXINPUTS=.;c:/abcwin/inputs//;c:/myabcs/". The period means
current directory, two slashes mean "and all subdirectories")

If everything works you can now delete ABCWIN.ZIP, ABC2DVI.ZIP and any 
temporary directories you created.  Otherwise read some more documentation, 
fiddle around, and when all else fails, email somebody for help.
