# README

    00001                       EO README FILE
    00002 =======================================================================
    00003          check latest news at http://eodev.sourceforge.net/
    00004 =======================================================================
    00005
    00006 Welcome to EO, the Evolving Objects library.
    00007
    00008 The latest news about EO can be found on the sourceforge repository at
    00009
    00010 http://eodev.sourceforge.net/
    00011
    00012 In case of any problem, please e-mail us at
    00013
    00014 eodev@egroups.com, eodev-main@lists.sourceforge.net
    00015
    00016
    00017 ==================================================================
    00018                       BUILDING EO
    00019 ==================================================================
    00020 The basic installation procedure goes the following:
    00021
    00022 Go to your build-directory and run
    00023     $(SRCDIR)/configure
    00024     make
    00025     make check
    00026     make install
    00027 where $(SRCDIR) is the top-level source directory of EO, i.e. where
    00028 the sources where unpacked.
    00029
    00030 See $(SRCDIR)/configure for possible options. You can specify to not
    00031 build example applications, the tutorial, or to build the ParadisEO
    00032 tutorial. You may also change the installation directory that way.
    00033
    00034 Now you should probably go to the tutorial and start learning about EO
    00035 features and programming.
    00036
    00037
    00038 In case of problems, you can read the INSTALL file - but remember this
    00039 is a standard installation file from GNU and that it contains nothing
    00040 specific about EO.
    00041
    00042
    00043 ===================================================================
    00044                        DIRECTORY STRUCTURE
    00045 ===================================================================
    00046 After unpacking the archive file, you should end up with the following
    00047 structure:
    00048
    00049 .../                            the MAIN EO dir, created when unpacking
    00050    |
    00051    +-- src                    SOURCE dir. Contains most EO .h files
    00052    |   |
    00053    |   +- utils          general utilities (e.g. RNG-related source files)
    00054    |   |
    00055    |   +- ga             bistring-genotypes source files
    00056    |   |
    00057    |   +- es             real-valued-genotypes source files
    00058    |   |
    00059    |   +- gp             Genetic Programming source files
    00060    |   |
    00061    |   +- obsolete       files from old versions - for upward compatibility
    00062    |
    00063    |
    00064    |
    00065    +-- tutorial               TUTORIAL dir (indeed :-)
    00066    |   |
    00067    |   +- html           all html files - start by browsing index.html
    00068    |   |
    00069    |   +- LessonX        for X=1, 2, 3, ... : example of increasing complexity
    00070    |
    00071    |
    00072    |
    00073    +-- doc                    DOCUMENTATION dir (generated by Doxygen)
    00074    |   |
    00075    |   +- html             HTML files - start at index.html (see also tutorial)
    00076    |   |
    00077    |   +- latex            latex files - use to generate Poatscript doc.
    00078    |   |
    00079    |   +- man              Unix man format documentation
    00080    |
    00081    |
    00082    +-- test                   TEST files - for debugging purposes only
    00083    |
    00084    |
    00085    +-- app                    APPLICATIONS - one dir per separate application
    00086    |   |
    00087    |   +- gprop            GA/backpropagation for neural nets
    00088    |   |
    00089    |   +- mastermind       the wellknown MasterMind game
    00090    |
    00091    |
    00092    +-- win                    WINDOWS dir: project files for MS/VC5+
    00093
    00094
    00095
    00096 ===================================================================
    00097               NOTES
    00098 ===================================================================
    00099 If you extracted a fresh snapshot from the cvs-repository, remember
    00100 to run
    00101     ./autogen.sh
    00102 in the source-directory before building the libraries.