Gobo Eiffel Project |

One of the main concerns of the Gobo Eiffel Project is to provide the Eiffel community with Eiffel tools and libraries that are free and portable across various Eiffel compilers available on the market. That way, you can still use your favorite Eiffel compiler while taking advantage of the goodies included in Gobo Eiffel.

The software included in this package is copyrighted freeware distributed under the terms and conditions of the MIT License as specified in the license file. Gobo Eiffel is a multi-developer open-source project whose development is hosted at Github while the official site (for stable releases) is located at gobosoft.com.

Gobo Eiffel already consists of seventeen Eiffel libraries:

- Gobo Eiffel Argument Library
- Gobo Eiffel Kernel Library
- Gobo Eiffel Lexical Library
- Gobo Eiffel Math Library
- Gobo Eiffel Parse Library
- Gobo Eiffel Pattern Library
- Gobo Eiffel Regexp Library
- Gobo Eiffel String Library
- Gobo Eiffel Structure Library
- Gobo Eiffel Test Library
- Gobo Eiffel Thread Library
- Gobo Eiffel Time Library
- Gobo Eiffel Tools Library
- Gobo Eiffel Utility Library
- Gobo Eiffel XML Library
- Gobo Eiffel XPath Library
- Gobo Eiffel XSLT Library

and eleven utilities:

- Gobo Eiffel Ant (geant)
- Gobo Eiffel Compiler (gec)
- Gobo Eiffel C Compilation (gecc)
- Gobo Eiffel Cop (gecop)
- Gobo Eiffel Doc (gedoc)
- Gobo Eiffel Lex (gelex)
- Gobo Eiffel Lint (gelint)
- Gobo Eiffel Preprocessor (gepp)
- Gobo Eiffel Test (getest)
- Gobo Eiffel XSLT Processor (gexslt)
- Gobo Eiffel Yacc (geyacc)

Note that these utilities are not needed if you just want to use the library classes provided in this package.

## Eiffel compilers

The supported Eiffel compilers, in alphabetical order, are:

- Gobo Eiffel Compiler (gec) 19.11.03.1
- ISE Eiffel 19.05.10.3187 and 19.10.10.3641 (Classic and .NET)

For more details about the supported Eiffel compilers, please see the file Release_notes.md. This software might work with other Eiffel compilers and/or other compiler versions, however no test has been made yet. To have a better understanding of the way this software has been designed and implemented, you can also have a look at portability issues.

## Platforms

The software provided in this distribution should work on any platform where supported Eiffel compilers are available. However this software has only been tested under Windows 10 and Linux. Since most Eiffel compilers use the notation $NAME for environment variables in their ECF files (or equivalent), this convention has been used instead of the Windowish %NAME%. Likewise, the directory separator used through out this distribution is '/', following Unix/Linux convention instead of the Windows '\' separator.

To install this package, please follow the instructions below:

#### Under Windows

- Download the package gobo*-src.7z, or check-out the files from the Git repository.
- Copy the files to a directory of your choice on your disk and set the environment variable %GOBO% to that directory, known as the distribution directory. Also put the directory %GOBO%\bin in your PATH.
- To build the tools (e.g. gec, geyacc, ...), execute the script:

  > %GOBO%\bin\install.bat <c_compiler>

  where <c_compiler> is a C compiler installed on your computer (for example use msc for Microsoft C compiler).

#### Under Unix/Linux

- Download the package gobo*-src.tar.gz, or check-out the files from the Git repository.
- Copy the files to a directory of your choice on your disk and set the environment variable $GOBO to that directory, known as the distribution directory. Also put the directory $GOBO/bin in your PATH.
- To build the tools (e.g. gec, geyacc, ...), execute the script:

  > $GOBO/bin/install.sh <c_compiler>

  where <c_compiler> is a C compiler installed on your computer (for example use gcc for GNU C compiler).

## Feedback

A list of the known defects along with eventual bug fixes or workarounds is available in the issue tracker on GitHub (an older bug tracker is available on SourceForge). If you find a bug which does not appear in this list yet, please report it. We will try to provide a bug fix as soon as possible (usually within one or two days).

You can also subscribe to the Gobo Eiffel mailing list and take part to the discussions or ask your questions there. There is another mailing list (hosted at SourceForge) for discussions about the features under development in the Git repository on GitHub.

Although the license allows you to do pretty much whatever you want with this software, we would be grateful to get your feedback, bug reports and/or bug fixes, improvements, etc. so that others could benefit from your work and ideas as well. We would also be interested in hearing about your projects and how easy (or difficult) it was to adapt this software for your specific needs. Thank you in advance.

You are also welcome to take part in the development of the Gobo Eiffel Project. Some developer guidelines are available to help you make the first steps.

## Download

Gobo Eiffel can be downloaded from various FTP sites worldwide. The development version of the Gobo project is also available via Git on GitHub.