======================================
        File:  oo2c_32-1.3.13-ppc.pkg
      Author:  Michael Griebling ([email protected])
     Release:  V1.3.13 for BeOS, 31 December 1998
Compatibility:  R3/R4
    Location:  contrib/lang
 Description:  Optimizing Oberon-2 compiler and libraries.
       Notes:  Now includes precompiled binaries and uses
               an automated installation.

I'm not the author of this package but only ported it to the BeOS
and contributed some of the library packages.  Please contact me at
the address above for BeOS porting questions and Michael van Acken,
one of the authors, at the address below.

----------------------------------------------------------------------
oo2c is the first compiler of the OOC project.  OOC's goal is to
provide optimizing native code Oberon-2 compilers for a number of
popular computer architectures.  The OOC home page is
 http://www.uni-kl.de/OOC/
Current oo2c versions and patches are available at
 http://www.uni-kl.de/OOC/files/oo2c/

The compiler's requirements are
 o a 32 bit Unix system
 o an ANSI-C compiler
 o ANSI and POSIX.1 libraries.
Please drop me a note if oo2c doesn't compile on your system although
it meets the above requirements.  I'll try to adjust the compiler
resp. its configuration process.

As of oo2c 1.3.6, the distribution no longer includes the sources of
Hans-J. Boehm's conservative garbage collector.  To use the garbage
collector, either install gc as a proper library, or unpack the
garbage collector sources in oo2c's top-level directory, prior to
running configure.  Also, oo2c now expects GNU libtool to be installed
on the target system.  See file INSTALL for details.

This distribution contains the OOC Reference Manual in info format and
as texinfo source.  The HTML version of the reference manual can be
found at
 http://www.uni-kl.de/OOC/OOCref/OOCref_toc.html
The manual is also available in texinfo, info, and postscript format
from the file server:
 http://www.uni-kl.de/OOC/files/docs/
Manual pages are also included, but the man page for the compiler oo2c
is only a subset of the information in the reference manual.


I've had reports of successful installation on the following systems:

operating system                compiler
-----------------------------   ---------------------------
Linux 2.0.35                    gcc 2.7.2.2
SunOS 4.1.2/3 aka Solaris 1.1   gcc 2.5.5, gcc 2.7.2
SunOS 5.4 aka Solaris 2.4       gcc 2.7.2.1, SunPRO-C 3.0.1
HP-UX A.09.01                   gcc 2.5.8, gcc 2.7.2.2
HP-UX B.10.20                   gcc 2.7.2.1
BeOS PR 2                       mwcc BeOS/R3

not verified again since oo2c version 1.0.0:
SunOS 5.5 aka Solaris 2.5 [1]   gcc 2.7.2.1
AIX 3.2.5                       gcc 2.7.0
IRIX 5.3                        gcc 2.7.2
SparcLinux 2.0.18 [2]           gcc 2.7.2

[1] on an UltraSPARC, compiled as 32 bit application
[2] needs --disable-gc


Needless to say, bug reports are welcome.  Please check first if the
bug is present in the most recent version of oo2c (see above for the
file server).  If this is the case, try to create a small program that
will reproduce the error.  Ideally this program is a single module
with just enough lines of code to trigger the bug.  Send me this
module, together with the following information:

 o how the bug manifests itself
 o the version of oo2c and the options you used to compile the program
   (add --write-config to oo2c's command line to obtain this information)
 o the C compiler (if possible with version number) oo2c builds upon and
   any additional options you passed to it
 o what operating system you're using

The latter two points are important if the bug is caused by some
quirk in the C compiler or OS.

                    -- Michael van Acken <[email protected]>

======================================