[gobo-eiffel-develop] Bootstrap from CVS

[Eric B. <er...@go...>]

Hi all,

It is now possible to bootstrap the Gobo tools from CVS.
The procedure is quite simple:

  . Check out the source code of Gobo.
  . Set the environment variable $GOBO.
  . Run either:

      $GOBO/work/bootstrap/bootstrap.bat <c_compiler> <eiffel_compiler>

    or:

      $GOBO/work/bootstrap/bootstrap.sh <c_compiler> <eiffel_compiler>

    depending on your platform. To find out about the already
    supported values for <c_compiler> and <eiffel_compiler>
    run the same command with the option '-help'.

For those who have already tried the bootstrap procedure
before, you would have noticed that there is no need to
set $GOBO_OS anymore (this variable still appears in some
geant build files, but it is internally interpreted by
'geant' -- in the same way 'gexace' can internally set the
value for $GOBO_EIFFEL).

There is not need for Makefiles anymore, and hence no cygwin
under Windows. However the directory $GOBO/test has not been
converted to geant build files yet. This will be done soon.

Later on, when you check out new classes or clusters, there
is usually no need to redo a full bootstrap again. Just
run:

  geant install

followed by:

  geant clean

in the root directory of the library these new classes or clusters
belong to. 'geant' actually finds its instructions in the file
'build.eant'. In order to know the possible command-line arguments
provided by a given build file, type:

  geant help

To come back to the bootstrap procedure, since not all C
compilers nor all platforms have been tested, you are welcome
to send patches and/or code to support other C compilers.

For what the Eiffel compiler is concerned, to run properly
the Gobo source code in CVS should be used with one of the
latest SmallEiffel beta releases, with at least ISE Eiffel 
5.0 (if you use ISE 4.5 you will have to copy 'es4.exe' to
'ec.exe' to have a chance to make it work), with Visual
Eiffel 3.3 (I think it doesn't work with VE 3.2 under Linux)
and with Halstenbach 4.0 (if you use ISS 3.0 you will have
at least to add DIRECTORY.create_dir to call `create' and
IO_MEDIUM.put_new_line to call `new_line' to have a chance 
to make it work).

Finally, note that the version of the Gobo package in CVS
is a development version and not an official release. The
bootstrap procedure is meant to be used by the Gobo developers
and by those who are interested in experiencing with new
functionalities at their own risk. In particular, people
willing to do code/design review, to beta test and/or to
submit patches/suggestions are welcome.

Enjoy!

-- 
Eric Bezault
mailto:er...@go...
http://www.gobosoft.com