Read Me

WELCOME TO GAMBAS!

GAMBAS is a free implementation of a graphical development
environment based on a BASIC interpreter. It is very
inspired by Visual Basic and Java.

More information on http://gambas.sourceforge.net


** IMPORTANT NOTES

Before downloading Gambas, compiling it and then complaining, please read the
following remarks CAREFULLY! 

To compile Gambas, you must install the following libraries on your system :
 
+=================================+==========================================+
| COMPONENTS                      | LIBRARIES                                |
+=================================+==========================================+
| gb.compress.bzlib2              | libbz2.so                                |
+---------------------------------+------------------------------------------+
| gb.compress.zlib                | libz.so                                  |
+---------------------------------+------------------------------------------+
| gb.corba                        | libACE.so libomniORB4.so                 |
|                                 | libomniDynamic4.so                       |
+---------------------------------+------------------------------------------+
| gb.crypt                        | libcrypt.so                              |
+---------------------------------+------------------------------------------+
| gb.db.firebird                  | libibpp.so libfbclient.so                |
+---------------------------------+------------------------------------------+
| gb.db.mysql                     | libmysqlclient.so libz.so                |
+---------------------------------+------------------------------------------+
| gb.db.odbc                      | libodbc.so                               |
+---------------------------------+------------------------------------------+
| gb.db.postgresql                | libpq.so                                 |
+---------------------------------+------------------------------------------+
| gb.db.sqlite                    | libsqlite.so                             |
+---------------------------------+------------------------------------------+
| gb.db.sqlite3                   | libsqlite3.so                            |
+---------------------------------+------------------------------------------+
| gb.gtk                          | All GTK+ libraries                       |
+---------------------------------+------------------------------------------+
| gb.ldap                         | libldap.so                               |
+---------------------------------+------------------------------------------+
| gb.net                          | -                                        |
+---------------------------------+------------------------------------------+
| gb.net.curl                     | libcurl.so                               |
+---------------------------------+------------------------------------------+
| gb.opengl                       | libGL.so libGLU.so                       |
+---------------------------------+------------------------------------------+
| gb.pcre                         | libpcre.so                               |
+---------------------------------+------------------------------------------+
| gb.qt                           | libqt-mt.so.3                            |
+---------------------------------+------------------------------------------+
| gb.qt.kde                       | All KDE libraries                        |
+---------------------------------+------------------------------------------+
| gb.sdl                          | libSDL.so                                |
+---------------------------------+------------------------------------------+
| gb.sdl.sound                    | libSDL.so libSDL_mixer.so                |
+---------------------------------+------------------------------------------+
| gb.sdl.image                    | libSDL.so libSDL_image.so libSDL_gfx.so  |
|                                 | libSDL_ttf.so                            |
+---------------------------------+------------------------------------------+
| gb.sdl.opengl                   | libSDL.so libGL.so libGLU.so             |
+---------------------------------+------------------------------------------+
| gb.v4l                          | libjpeg.so libpng.so video4linux >= 2.0  |
+---------------------------------+------------------------------------------+
| gb.xml                          | libxml-2.0                               |
+---------------------------------+------------------------------------------+
| gb.xml.xslt                     | libxslt                                  |
+---------------------------------+------------------------------------------+

And you must install all related development packages. 

Try to always use a recent version of these libraries.

You must of course install the GCC compiler.

You must compile gb.qt and gb.qt.ext components to have a working development
environment.

Qt 3.2 is now required because of one Qt function that was missing in older
versions of Qt. Gambas will compile with Qt 3.1, but the function Picture.Copy()
will fail in some case. Gambas does not compile with previous versions of Qt. 

You must have the right to write to /tmp, otherwise Gambas will not work. 

This package was done with the following versions of GNU tools: 
 - automake 1.9.4 
 - autoconf 2.59 
 - libtool 1.5.12 (this tool is not required as it is included in the package) 

Each sub-directory of this source package is actually independent. You can 
configure, make and install each of them independently.

 
** DISTRIBUTION SPECIFIC PROBLEMS

Read the README.REDHAT or README.FEDORA files.


** HOW TO COMPILE GAMBAS ?

1) First, check that you installed all the needed development packages

2) When done, type the following magic sentences in a shell.
   '#' represents your shell prompt, and "..." are the
   messages printed during the configuration and compilation.

  This command analyzes the system and configure the package:

     # ./configure -C
     ...

   This command compiles the programs:

     # make
     ...

   And finally this command installs everything:

     # su -c "make install"
     Password: <Type the root password here>
     ...

   If something fails during this process, try to type the
   following command before ./configure :

     # ./reconf

   If it does not work, I need to know what happened exactly.
   To do so, type the following command :

     # ( ./configure; make; make install ) > output.txt 2>&1

   And send me the file "output.txt" by mail, with every other
   detail about your computer and your distribution you find
   useful.

3) If everything was fine, type "gambas2" to run the development
   environment. There are a few examples in the "examples"
   directory.

4) There are more 'configure' specific explanations in the "INSTALL" file.
   I invite you to read them.

Enjoy it !

Benoît.