home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / oxcc1433.zip / README.TXT < prev    next >
Text File  |  1995-11-06  |  5KB  |  129 lines
  1.  
  2.                            OXCC C Compiler
  3.                             Version 1.433
  4.                             Nov 5, 1995
  5.  
  6.                Copyright (c) 1994, 1995 by Norman D. Culver
  7.                           All Rights Reserved.
  8.  
  9.  
  10.                     Send bug reports and suggestions to:
  11.                             Oxbow Software
  12.                        1323 S.E. 17th Street #662
  13.                         Ft. Lauderdale, FL 33316
  14.                          (305) 527-1663 Phone
  15.                          (305) 760-7584 Fax
  16.                             ndc@gcomm.com
  17.  
  18.  
  19.         This software package is distributed as a preliminary version for
  20.                 TESTING PURPOSES ONLY, WITHOUT ANY WARRANTY;
  21.                    without even the implied warranty of
  22.             MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  23.  
  24.              This product includes software developed by the
  25.              University of California, Berkeley and its contributors.
  26.  
  27.  
  28.  
  29. INSTALLATION FOR DOS BASED MACHINES
  30.  
  31.     c:
  32.     mkdir \oxbow
  33.     cd \oxbow
  34.     unzip -d oxcc1433        // or pkunzip
  35.     make                    // runs the batch file make.bat
  36.     
  37.    At this point you will have a number of .exe files in the oxbow
  38.    directory. You can add oxbow to the PATH variable in autoexec.bat
  39.    or you can move the .exe files to a preferred directory.
  40.    If you don't like the directory name `oxbow' you can pick another
  41.    name but you will have to enter an environment variable `OXPATH'
  42.    in the autoexec.bat file. e.g. SET OXPATH=mydir   
  43.  
  44.   
  45. WHAT IS OXCC AND WHY SHOULD YOU BE INTERESTED
  46.  
  47.    OXCC is a multipass, interpreting C compiler with several language
  48.    extensions. It generates an Architecture Neutral Format (ANF) output
  49.    and comes with a couple of example back ends. Programmers are expected
  50.    to write additional back ends for their specific needs.
  51.    
  52.    Language extensions have been inspired by GCC, MSC and Watcom C.
  53.    OXCC is designed to produce 16 bit, 32 bit, 64 bit, segmented and
  54.    flat model code for any target architecture and operating system.
  55.    YOU WRITEM.
  56.  
  57.    OXCC can interpret its' input, it can also regenerate source code
  58.    after interpretation. Source regeneration properly handles `malloced'
  59.    data containing pointers. Slow mode interpretation keeps track of all
  60.    pointers, references and initializations, including hidden pointers.
  61.    
  62.    OXCC is also callable as a subroutine or class from within the framework.
  63.    It can even be called by a program which is being compiled (see toxcc.c).
  64.    When called as a subroutine, the user can access all of the interesting
  65.    internal structures such as the Abstract Syntax Tree and the symbol table
  66.    at various stages of the multipass compilation.
  67.  
  68.  
  69. CONTENTS OF THIS DISTRIBUTION after running make.bat
  70.  
  71.    oxbow.a              a.out,coff archive -- djcc v1.10. v1.12 compiled
  72.    oxlib.cff            cff filesystem and archive            (see cff.txt)
  73.    oxcc.cff             C compiler + include files            (see oxcc.txt)
  74.    obj4lb.exe           symbol table whapper utility          (see obj4lb.txt)
  75.    cfrun.exe            skeleton framework and dynamic linker (see skel.txt)
  76.    oxcc.exe             the compiler                          (see oxcc.txt)
  77.    oxccb.exe            ANF to byte code back end (sample)    (see oxccb.txt)
  78.    bterp.exe            byte code interpreter (sample)        (see bterp.txt)
  79.    oxccl.exe            ANF linker                            (see oxccl.txt)
  80.    oxccai.exe           ANF to Intel assembler code back end (incomplete)
  81.    cfar.exe             archiver for .cff filesystems
  82.    cfls.exe             lister for .cff and DOS filesystems (derived from GNU)
  83.    make.bat             batch file to make some .exe files
  84.    test.bat             batch file to test the compiler and byte code interpreter
  85.    changes.txt          notes about what changed between versions
  86.    readme.txt           this file
  87.  
  88.    doc/anf.txt          documentation for ANF
  89.    doc/bterp.txt        documentation for bterp
  90.    doc/oxcc.txt         documentation for oxcc
  91.    doc/oxccb.txt        documentation for oxccb
  92.    doc/oxccl.txt        documentation for oxccl
  93.    doc/cfar.txt         documentation for cfar
  94.    doc/cfls.txt         documentation for cfls
  95.    doc/skel.txt         documentation for cfrun
  96.    doc/obj4lb.txt       documentation for obj4lb
  97.    doc/c.grm            C grammar for oxcc
  98.  
  99.    src/obj4lb.c
  100.    src/cfar.c
  101.    src/cff.h
  102.    src/cfls.4lb
  103.    src/cfls.c
  104.    src/cfls.h
  105.    src/lrandom.c  from BSD
  106.    src/oxanf.h
  107.    src/oxbytes.h
  108.    src/oxcc.h
  109.    src/oxccb.c
  110.    src/oxccl.c
  111.    src/oxccai.c
  112.    src/bterp.c
  113.    src/skeleton.c
  114.    src/skeleton.mak
  115.    src/oxccb.mak
  116.    src/cfutil.mak
  117.    src/oxlib.map        verbose map of oxlib.cff
  118.    src/makoxlib.bat     batch file to recreate oxlib.cff (info only)
  119.    src/oxcc.map         verbose map of oxcc.cff
  120.    src/makoxcc.bat      batch file to recreate oxcc.cff (info only)
  121.  
  122. QUICK TEST
  123.  
  124.    After running `make.bat' and placing the .exe files in a directory in
  125.    your path, or setting OXPATH; you can run `test.bat' which exercises the
  126.    compiler `oxcc', the byte code backend `oxccb' and the byte code
  127.    interpreter `bterp'.
  128.  
  129.