
                           OXCC C Compiler
                            Version 1.430
                            July 9, 1995

               Copyright (c) 1994, 1995 by Norman D. Culver
                          All Rights Reserved.


                    Send bug reports and suggestions to:
                            Oxbow Software
                       1323 S.E. 17th Street #662
                        Ft. Lauderdale, FL 33316
                         (305) 527-1663 Phone
                         (305) 760-7584 Fax
                      norman.culver@channel1.com


        This software package is distributed as a preliminary version for
                TESTING PURPOSES ONLY, WITHOUT ANY WARRANTY;
                   without even the implied warranty of
            MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

 			This product includes software developed by the
 			University of California, Berkeley and its contributors.



INSTALLATION FOR DOS BASED MACHINES

    c:
	mkdir /oxbow
	cd /oxbow
    unzip -d oxcc1430		// or pkunzip
    make					// runs the batch file make.bat
    
   At this point you will have a number of .exe files in the oxbow
   directory. You can add oxbow to the PATH variable in autoexec.bat
   or you can move the .exe files to a preferred directory.
   If you don't like the directory name `oxbow' you can pick another
   name but you will have to enter an environment variable `OXPATH'
   in the autoexec.bat file. e.g. SET OXPATH=mydir   
  

WHAT IS OXCC AND WHY SHOULD YOU BE INTERESTED

   OXCC is a multipass, interpreting C compiler with several language
   extensions. It generates an Architecture Neutral Format (ANF) output
   and comes with a couple of example back ends. Programmers are expected
   to write additional back ends for their specific needs.
   
   Language extensions have been inspired by GCC, MSC and Watcom C.
   OXCC is designed to produce 16 bit, 32 bit, 64 bit, segmented and
   flat model code for any target architecture and operating system.
   
   OXCC can interpret its' input, it can also regenerate source code
   after interpretation. Source regeneration properly handles `malloced'
   data containing pointers.
   
   OXCC is also callable as a subroutine or class from within the framework.
   It can even be called by a program which is being compiled (see toxcc.c).


CONTENTS OF THIS DISTRIBUTION

   oxbow.a              a.out archive -- djcc compiled
   oxlib.cff            cff filesystem and archive            (see cff.doc)
   cfin.cff             small archive for the program `cfin'  (see cfin.doc)
   cfar.cff             small archive for the program `cfar'  (see cfar.doc)
   cfdel.cff            small archive for the program `cfdel' (see cfdel.doc)
   cfls.cff             small archive for the program `cfls'  (see cfls.doc)
   aout4lb.exe          symbol table whapper utility          (see aout4lb.doc)
   cfrun.exe            skeleton framework and dynamic linker (see skel.doc)
   oxcc.exe             application manufactured by make.bat  (see oxcc.doc)
   oxccb.exe            ANF to byte code back end             (see oxccb.doc)
   bterp.exe            byte code interpreter                 (see bterp.doc)
   oxccl.exe            ANF linker                            (see oxccl.doc)
   cfar.exe             archiver for .cff filesystems
   cfin.exe             file inputter for .cff filesystems
   cfls.exe             lister for .cff and DOS filesystems (derived from GNU)
   cfdel.exe            deleter for .cff filesytems
   make.bat             batch file to make some .exe files
   test.bat             batch file to test the compiler and byte code interpreter
   changes              notes about what changed between versions

   doc/anf.doc          documentation for ANF
   doc/bterp.doc        documentation for bterp
   doc/oxcc.doc         documentation for oxcc
   doc/oxccb.doc        documentation for oxccb
   doc/oxccl.doc        documentation for oxccl
   doc/cfar.doc         documentation for cfar
   doc/cfin.doc         documentation for cfin
   doc/cfdel.doc        documentation for cfdel
   doc/cfls.doc         documentation for cfls
   doc/skel.doc         documentation for cfrun
   doc/aout4lb.doc      documentation for aout4lb
   doc/c.grm            C grammar for oxcc

   src/aout4lb.c
   src/cfar.c
   src/cfdel.c
   src/cff.h
   src/cfin.c
   src/cfls.4lb
   src/cfls.c
   src/cfls.h
   src/cfport.c
   src/cmalloc.c
   src/ecall.s
   src/go32.exe
   src/lrandom.c
   src/oxanf.h
   src/oxbytes.h
   src/oxcc.h
   src/oxccb.c
   src/oxccl.c
   src/oxccai.c
   src/bterp.c
   src/oxccb.mak
   src/cfutil.mak


QUICK TEST

   After running `make.bat' you can run `test.bat' which exercises the
   compiler `oxcc', the byte code backend `oxccb' and the byte code
   interpreter `bterp'.

