
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 packages on your system : 
 - The X11 development packages. 
 - The Qt 3 development packages. 
 - The KDE 3 development packages if you want to compile the KDE component. 
 - The PostgreSQL, MySQL or SQlite development packages if you want to compile
   database drivers. 
 - The libcurl development packages (version 7.10.7 or greater) if you want to
   compile the curl component. 
 - The SDL and SDL_mixer development packages if you want to compile the SDL 
   components.
 - The libxml and libxslt development packages if you want to compile the XML
   components.
 - The GTK+ development packages if you want to compile the GTK+ component.
 - ...and so on!

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.8.5 
 - autoconf 2.59 
 - libtool 1.5.6 (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 files README.REDHAT, README.DEBIAN, or README.FEDORA


** 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 "gambas" 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.
