Bsc is a program which creates BinSCII files on UNIX systems.


COMPILING
---------

First, examine the makefile.  For some systems, you may need to add some of
the -Dxxx flags to CFLAGS.  These flags are briefly described in the
comments in the makefile.

Once you have CFLAGS set up to match your system, type "make".  This should
build the bsc executable.  If it doesn't, you might want to write to the
author (at the one of the addresses listed at the end of this file) and
tell him he goofed.  You get extra credit if you can describe the reasons
for the failure in sufficient detail for me to correct the problem.

Once you have bsc successfully compiled, move it to your favorite
directory.  It doesn't really matter where you put it, as long as you can
find it when you need it.

The documentation on running bsc is in the file bsc.1, in UNIX man page
format.  The file bsc.1 should be installed somewhere where your man
command can find it.  (If you can't write to the /usr/man directory, and
you have a brain-dead man command that can't find man pages in non-standard
places, then you can type "make catman" to turn the man page into an
ordinary text file ("bsc.1.txt").)

INFORMATION
-----------

This program is freeware.  It comes with no warranty of any kind--in
particular, I cannot guarantee that it is free of bugs.  Use it at your
own risk.

When the inevitable bugs DO appear, send e-mail to one of the addresses
below.  I welcome bug reports, comments, complaints, and suggestions for
improvement.

Thanks to Marcel J. E. Mol, whose sciibin program was a valuable source
of technical information on BinSCII.

               - Neil Parker
                 parker@corona.uoregon.edu
                 nparker@cie.uoregon.edu

Version 1.2