
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 de network-curl component. 
 - The SDL and SDL_mixer development packages if you want to compile the SDL 
   component.

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. 

Gambas does not compile with gcc 3.0.x. It seems that it is a bug of gcc. Use
gcc 3.2 instead. (Note that there is a not yet resolved include file clash with
gcc 2.9x). 

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

If you want to run the ./reconf script included in the package (to develop a 
new component, or modify a existing one) , you must use 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) 

 
DISTRIBUTION SPECIFIC PROBLEMS

Read the files README.REDHAT or README.DEBIAN


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
     ...

   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 explanations in the "INSTALL" file. I invite
   you to read them.

Enjoy it !

Benot.
