12345678901234567890123456789012345678901234567890123456789012345678901234567890

You may see strange characters in ExtractBCC and MakeFile.mac.  Do not worry,
this is normal.  These are special Macintosh characters with character codes
greater than 0x7f.  These two files are used only on the Mac.

You should set your text editor to have tab stops every four columns.  The
source files have been formatted for this.  Actually, you should be able to use
any tab setting from 3 to as wide as your screen will handle.

Multiple makefiles are included.  Choose the one that matches your environment.
It is expected that you'll duplicate and rename it to Makefile (or MakeFile).
Note that the Mac makefile will copy changes in itself back to MakeFile.mac.

All the environment specific defines should be in the file HostTypes.h.  "card"
is short for cardinal, ie, whole numbers.  If you are porting to DOS/Windows,
check if your system defines MSDOS.  This is needed to select the correct
newline sequence for hex format output.

MacObject.c is only included in Macintosh versions.  The code itself doesn't use
any Mac specific functions, but the data files it reads contain big-endian data.
It would be way too messy to change the code to run on unknown-endian systems.

If you make source code changes, please log them in ChangeLog.  Hopefully they
will then not get lost and can be incorporated into the baseline version.

If you edit IdentifyBCC.r to add CRC's of stock chips, please also add the CRC
to EditBCC.  Data changes in EditBCC, IdentifyMask.r, and IdentifySpec.r are
expected, they don't need to be logged in ChangeLog.

The data in IdentifyBCC.r should not be taken as the gospel truth.  If you have
a known stock chip which doesn't match the data, please edit ExtractBCC (in
addition to IdentifyBCC.r).  At the top of ExtractBCC, there are commands to
fix data errors.

Here is BitHoist's command line syntax:

# Usage: BitHoist [options] input... < input > output
	           # Options and inputs may be intermixed
	-stdin     # Use standard input as input file
	-offset nn # Offset next input file data by nn
	           #   Applies to next input specification
	-r ii,jj   # Include locations ii through jj
	-r ii      # Include location ii
	-e ii,jj   # Exclude locations ii through jj
	-e ii      # Exclude location ii
	           #   Multiple -r and -e are allowed
	-o file    # Output data to file
	-stdout    # Output data to standard output
	           #   Default is no output
	-offset nn # Offset output data by -nn
	           #   Applies to following output specification
	-b         # Binary format output (default)
	-i         # Intel hex (16/20/32 bit) output
	-m         # Motorola hex (16/24/32 bit) output
	-t         # Tektronix extended hex (4-64 bit) output
	-hex       # Tektronix hex (16 bit) output
	-mos       # MOS Technology hex (16 bit) output
	-sig       # Signetics hex (16 bit) output
	-fix       # Repair sumcheck and mask fields
	-w nn      # Output nn bytes per hex format line
	-id        # Identify mask and broadcast code
	-mask      # Print program code for mask dossier
	-raw       # Don't identify and auto-offset data
