The Goanna tools and examples use the GOBO geant and gexace tools to perform Ace file generation and to control the compilation process. You will need to have a recent CVS version of GOBO on your system to build Goanna.
All scripts rely on the enviornment variable GOANNA. It should be set to the root directory of the Goanna installation.
To initialise the library, build all examples and all tools, you can run geant on the build.eant file located in the root directory of the Goanna installation. To install the library on Unix, run:
To install the library on Windows, run:
To compile individual examples or tools you must first prepare the library by running geant in the library directory. This will generate compiler specific files for all '.ge' files by using the gepp GOBO tool. Once the library has been initialised you can execute geant in a particular example or tool directory.
The build rules provided by the geant files include:
For example, to build the standalone web server example using ISE Eiffel on Unix, run:
This will compile the example using ISE Eiffel in finalization mode. An executable will be generated in the current directory. If you need to compile in debug mode, then use the build rule 'compile_debug' instead. To use the SmallEiffel compiler set the GOBO_EIFFEL variable to 'se'. You can also force the use of a particular compiler by using the build rules 'compile_ise', 'compile_se', 'compile_debug_ise' and 'compile_debug_se'.
Build rules are also provided to compile with the HACT and VisualEiffel compilers, however no testing has been performed using these compilers. If you have any success with these compilers please let Glenn Maughan know.
If you run geant without any arguments it will display the build rules available in the 'build.eant' file found in the current directory.
Note, some of the library clusters and examples will not compile under SmallEiffel. They will be ported to SmallEiffel when time permits and compiler support allows. The following table shows the progress of the porting effort.
|library/utility/codegen||Yes||No (ISE classes)|
|src/bdv||Yes||No (ISE classes)|
|src/xmle||Yes||No (ISE classes)|
|examples/bachelor||Yes||No (ISE classes)|
|examples/dom_printer||Yes||No (ISE classes)|
|examples/xmlrpc/client/addressbook||Yes||No (Vision, agents)|
|examples/xmlrpc/client/calculator||Yes||No (Vision, agents)|
|examples/xmlrpc/client/currenttime||Yes||No (Vision, agents)|
|examples/xmlrpc/client/spellchecker||Yes||No (Vision, agents)|