------------------------------------------------------------------------
GENESIS

Genesis is the compiler and run-time interpreter/daemon for ColdC, and
is produced by the Cold Project.  You can learn more about helping to
support the Cold Project at:

    http://www.cold.org/support/

******** This is the Developmental release of    ********
******** Genesis and should be used with caution ********

Release information can be found in doc/CHANGES.  A list of tasks can
be found in doc/TODO.

------------------------------------------------------------------------
INSTALL/COMPILATION IN UNIX

To compile simply type 'make'.

Installation is undefined as people generally move the binaries to
other locations.  Generally you should copy 'coldcc' and 'genesis' to
your world directory (wherever it may be).

The directory 'bin' contains a few useful scripts.

Full installation instructions can be found at:

      http://www.cold.org/Software/Genesis/

NOTE: Because SunOS 4.1.x is not POSIX compliant nor even ANSI complaint
      there are certain problems that will arise in running Genesis on
      that type of system.  Unfortunately, they are serious problems
      which cause unstability in Genesis.  We suggest upgrading to
      a modern operating system.  NetBSD will likely run on your same
      hardware, and is free.

------------------------------------------------------------------------
INSTALL/COMPILATION IN WIN32

You will need an ndbm implementation in Win32.  You can get GNU's ndbm
implementation (gdbm) to cover this role.  You must first have access
to a unix system, with either bison or yacc.  Read doc/Win32-INSTALL
for full instructions.

------------------------------------------------------------------------
FURTHER INFORMATION

The following email lists are available:

    coldstuff           Generic cold-related list
    coldcore            Generic discussion in relation to the ColdCore
    coldcore-bugs       Bug (feature) reporting for the ColdCore
    coldcore-hackers    ColdCore development list
    genesis             Generic discussion in relation to Genesis (ColdC driver)
    genesis-bugs        Bug (feature) reporting for Genesis
    genesis-hackers     Genesis development list

You can easilly subscribe to the lists at:

    http://www.cold.org/info.html

Or by sending a mail message to majordomo@cold.org with a 'subscribe list'
line for each list.  For instance, if you wanted to subscribe to 'coldstuff'
and 'coldcore', your message body would be:

subscribe coldstuff
subscribe coldcore

All lists are at cold.org (i.e. coldstuff@cold.org).

Lists are archived at:

    http://www.cold.org/info.html

Documentation:

    for Genesis:     http://www.cold.org/Genesis/
    for ColdC:       http://www.cold.org/ColdC/

------------------------------------------------------------------------
NOTES

Verified to compile and run on:

    * FreeBSD (Any version after 2.0)
    * DEC OSF/1 2.0, 3.2
    * DEC Ultrix 4.4
    * Sun Solaris 2.5
    * Linux (although problems will arise 1.2.x versions)

You will get the best results in FreeBSD, as it is the development platform
so possible problems are immediately found.