READ68K.ME - read me file for CP/M-68K version of SDB
Robert Heller. Created: Sun Oct 26, 1986 03:14:54.58


I downloaded David Betz's SDB files from BIX (listings/c+unix/sdb.1,
sdb.2, sdb.3), and after a bit hacking, got a running version for my
CP/M-68K v1.2 system (Stride 440).  I also built the (missing) files to
allow using the SDB system from a user-written C program.  All of the
chenges I made are either embedded in #ifdef CPM68K/#endif's or else
were changes which should have been the original anyway, mostly missing
parameter decl's. I also put in some register declarations and replaced
"static" with "LOCAL" (a macro conditionally defined as static), to aid
debugging - this will only improve the generated code or have no effect.

The extra files I created are:

MAKEFILE.SUB   - A file to re-compile and link the whole thing.  This is
                 setup for my system, which has the system files (C
                 compiler, assembler, linker, and header files) on drive
                 D: and uses my own version of ERA, which is smarter
                 than the built-in ERA command.  You will have to modify
                 this if you need to use it.  Should not be difficult.
                 Also, the link step assumes that all of the object code
                 on the current drive is for SDB - you probably should
                 only run this on a "clean" diskette or hard disk
                 partition (i.e. one that does not have anything else on
                 it).  This is setup to use the Motorolla Fast Format
                 Floating Point library.  The SRT.C module is the only
                 module that uses floating point arithmetic. (I renamed
                 the UNIX MAKEFILE to MAKEFILE.UNX.)
SDBLNK.SUB     - Relinks SDB.  This is just the last command extracted
                 from MAKEFILE.SUB.  Used when only one or two modules
                 have been changed and re-compiled.
SDB.H          - Header file for user programs.  This is an edited
                 version of SDBIO.H (used by SDB code itself) intended
                 for use by user-written programs.
SDBULNK.SUB    - Link step for user programs.  Works like CLINKF.SUB -
                 parameter #1 is used for the name of the .68K file &
                 first .o file and parameters 2 thru 9 are used for the
                 second thru ninth .o files.  Again, this is setup for
                 my system, so you'll need to change it for your system.
                 Is setup for the Motorolla Fast Format Floating Point
                 library.  Could be changed.  None of the SDB routines
                 that are user callable use floating point, so don't
                 care.
EXAMPLE.C      - This is the example program lifted from SDB.MEM.
SDBLIB         - This is an object library (archive), containing the
                 modules that are callable from user written programs.

            Robert Heller
ARPANet:    Heller@UMass-CS.CSNET
BITNET:     Heller@UMass.BITNET
BIX:        Heller
GEnie:      RHeller
FidoNet:    Robert Heller, 101/27 (Dave's Fido)