home *** CD-ROM | disk | FTP | other *** search
/ Aminet 10 / aminetcdnumber101996.iso / Aminet / dev / c / vbcc.lha / readme.vbcc
Text File  |  1995-11-23  |  4KB  |  142 lines
  1.  
  2.  
  3. vbcc - portable ANSI C compiler (c) in 1995 by Volker Barthelmann
  4.  
  5.  
  6. INTRODUCTION
  7.  
  8.     vbcc shall be a free portable ANSI compliant C compiler.
  9.  
  10.     This is the version for 68k based Amiga systems (the only existing
  11.     version at the moment). This version is still beta, so You
  12.     should use it with care and send me bugreports, suggestions etc.
  13.     Also the manuals are rather poor and the installation is not very
  14.     easy (will hopefully change in the future).
  15.  
  16.     This archive contains the compiler, a frontend, startup codes,
  17.     a C library, an amiga.lib replacement and a utility to create
  18.     stubs for Amiga shared libraries (everything with source).
  19.  
  20.     However You have to get a preprocessor, an assembler and a linker
  21.     to use it (all can be found on aminet, see below). If You want to
  22.     compile Amiga specific programs or rebuild the libraries or the
  23.     frontend You need the C= includes which can be found on certain
  24.     CDs (that are mounted on certain ftp-Servers).
  25.  
  26.  
  27. SOME GOOD THINGS
  28.  
  29.     vbcc..
  30.  
  31.     - comes with source
  32.  
  33.     - is free
  34.  
  35.     - is portable (so if AT manage to port AmigaOS...)
  36.  
  37.     - should be (rather) ANSI compliant
  38.  
  39.     - can generate code that runs on a plain 68000 CPU
  40.  
  41.     - can generate code that uses instructions/addressing modes of
  42.       the 68020 and higher CPUs
  43.  
  44.     - can generate code that uses the 68881/2 FPUs directly
  45.  
  46.     - generates standard Amiga object files
  47.  
  48.     - does not need too much memory
  49.  
  50.  
  51. SOME BAD THINGS
  52.  
  53.     vbcc..
  54.  
  55.     - comes with source
  56.  
  57.     - is still beta and may still have serious bugs
  58.  
  59.     - is not yet completely ANSI compliant
  60.  
  61.     - does not yet have an own preprocessor (in the works)
  62.  
  63.     - is rather slow
  64.  
  65.     - does not yet have a real optimizer
  66.  
  67.     - has poor documentation
  68.  
  69.  
  70. INSTALLATION
  71.  
  72.     [In the future the installation hopefully becomes much easier.]
  73.  
  74.     After unpacking the archive You need a preprocessor, assembler
  75.     and linker.
  76.  
  77.     assembler:
  78.  
  79.         You have to use a recent version of FreePhxAss (c) by
  80.         Frank Wille. Get the archive dev/asm/PhxAss???.lha from
  81.         aminet.
  82.  
  83.         Copy FreePhxAss to vbcc/machines/amiga68k/bin.
  84.  
  85.     linker:
  86.  
  87.         You need a decent linker that uses standard Amiga object
  88.         files. You can e.g. use PhxLnk which is contained in the
  89.         PhxAss-archive (only PhxLnk will allow You to use SmallData
  90.         and SmallCode models with vbcc). However PhxLnk is very slow
  91.         with large libraries, so You might try another linker.
  92.  
  93.         Copy the linker to the same bin directory.
  94.  
  95.     preprocessor:
  96.  
  97.         Now You need an external preprocessor. One possible solution is
  98.         dcpp which can be found in the FreeDice.lha archive on aminet
  99.         (probably in dev/c). However this preprocessor is far from ANSI
  100.         compliant and You may want to use another one.
  101.  
  102.         Copy the preprocessor to the same place.
  103.  
  104.     As the supplied binary of vbcchas been compiled with gcc (vbcc can
  105.     compile itself, but the vc.lib is not yet optimized so the gcc
  106.     compiled version is significantly faster) You need ixemul.library.
  107.     This can be found on aminet and must be copied to LIBS:.
  108.  
  109.     Now read all the #?.doc files in vbcc/doc and in
  110.     vbcc/machines/amiga68k/doc. The further installation is described in
  111.     vbcc/machines/amiga68k/doc/vc.doc.
  112.     Note that if You use PhxLnk and dcpp You can use the provided vc.config
  113.     file, otherwise You will have to edit it.
  114.  
  115.     Future (non-beta) versions of vbcc will probably have a builtin
  116.     preprocessor and come with all necessary files and an installer-script.
  117.  
  118.  
  119. BUGREPORTS
  120.  
  121.     There may still be many bugs in vbcc, the libraries, include files etc.
  122.  
  123.     If You find that vbcc generates bad code, throws enforcer hits, crashes,
  124.     accepts incorrect sources, rejects correct sources etc., please
  125.     send a mail with Your system configuration, the vbcc version, the
  126.     command line You used, the source that caused the problem and a
  127.     brief description of the problem to
  128.  
  129.         volker@vb.franken.de
  130.  
  131.     Also if You find problems with the includes, the libraries or You have
  132.     suggestions, dislikes etc. send me a mail.
  133.     Corrections, improvements etc. of the manuals are appreciated, too.
  134.  
  135.  
  136.  
  137. Volker Barthelmann                                      volker@vb.franken.de
  138. Kennedy-Ring 39
  139. 91301 Forchheim
  140. Germany
  141.  
  142.