Gambas Documentation - /doc/release/3.1.0

# Gambas 3.1.0

- What's new

- ChangeLog

- Requirements

- Compilation & Installation

  - Check installation

  - Source package configuration

  - Compilation

  - Installation

  - Troubleshooting

  - Running Gambas

## What's new

This new release fixes more than 150 bugs and adds more than 120 new features.

All Gambas 3.x versions will be backward-compatible, i.e. a program written in Gambas 3.0 version will be able to run unchanged with any Gambas 3.x version. But the contrary is false: a program written with a specific Gambas 3.x version will not run with an older version.

Beware that this is taken into account by the IDE packager only since Gambas 3.1!

Here is a short list of the main new features and bug fixes. I suggest that you read the full ChangeLog anyway!

In the development environment:

- The packager is now usable and reliable. Generated packages now have dependencies on Gambas version greater or equal than 3.1.0 and strictly lower than 3.99.0.

- The form editor has now undo and redo support.

- ASP-like webpage support.

- Libraries now can have requirements exactly like components.

- The debugger is more clever: it can displayed the contents of array-like and collection-like classes.

In the interpreter:

- CHMOD, CHOWN and CHGRP were implemented.

- The MkBool$, MkShort$, MkInt$... functions made a come back.

- Libraries are now managed like components, i.e. their dependencies are not loaded automatically.

- The old GOSUB instruction has been implemented.

- The interpreter stack is now allocated through the mmap() system call, making it very fast.

In the compiler:

- A property now can has up to four different synonymous names.

- ASP-like webpage support.

In the components:

- gb.db.form has been fixed.

- The native gridview control has been replaced and enhanced by a control entirely made in Gambas. This control can handle millions of lines without eating all memory.

- gb.gsl is a new component made by Randall Morgan that will provide an interface to the GNU Scientific Library.

- Control.NoTabFocus is a new property that prevents a control from being in the TAB key focus chain.

- The Gambas code editor undo management has been fixed.

Enjoy it!

## ChangeLog

    [CONFIGURATION]
    * BUG: Explicitely use /bin/bash in the make-component script.
    * NEW: Update the TEMPLATE directory and its script.

    [DEVELOPMENT ENVIRONMENT]
    * BUG: In Report forms, draw ReportImage and ReportSvgImage according to
      their Stretch property.
    * BUG: Table chooser works correctly again.
    * BUG: Do not try to handle Home and End keys in editors.
    * BUG: Fix the translation of error messages made by the debugger.
    * BUG: Information system dialog is now better at detecting libraries.
    * BUG: Fix some crash in database manager when removing fields or index.
    * BUG: Fix background and foreground color buttons order in the icon
      editor.
    * BUG: Do not allow to add source files in the data directory, and data
      files in the source directory.
    * BUG: Fix handling of null String[] properties.
    * BUG: Fix filters in the file creation dialog.
    * BUG: Fix the form editor grid horizontal position.
    * BUG: Correctly use the project tabulation size in automatic structure
      completion.
    * BUG: Fix the tips of the day language selection.
    * BUG: Changing the number of tabs of a Report works again.
    * BUG: Fix a possible crash when the form editor gets a spurious resize
      event whereas undo management has been uninitialized.
    * BUG: Correctly handle libraries that depends on more than one component.
    * BUG: Pasting text as comments correctly converts tabulations into spaces.
    * BUG: Set the focus back to the editor after a paste operation.
    * BUG: Try to fix the spurious error that is raised sometimes when clicking
      on a control in the form editor.
    * BUG: Make error message tooltips always visible.
    * BUG: Fix error when inserting a new form with dialog management option
      checked.
    * BUG: Fix version requirements on components in the packager.
    * BUG: Many Shell$() calls were forgotten in the packager code.
    * BUG: Don't save cursor position during a text selection.
    * BUG: Help browser toolbar now uses the small font size defined in the
      option dialog.
    * BUG: The default vendor prefix is now "gambas3" and not "gambas", so that
      component packages are correctly named.
    * BUG: Fix extra files and extra dependencies tables in the packager.
    * BUG: Fix file information dialog.
    * BUG: In the open project dialog, setting the recent files sorting mode
      now correctly takes the filter into account.
    * BUG: Fix packages version requirements. Minimal version is the current
      one (3.1) and maximum version is 3.99.0.
    * BUG: Fix extra files management in the packager. Workaround a Debian
      design flaw in packaging tools.
    * BUG: Do not try to move to a specific line when opening a form.
    * BUG: In the packager wizard, check that each extra file has a target
      directory.
    * BUG: Fix the Slackware packaging routine.
    * BUG: Autocompletion on ME now works correctly for WebPage.
    * BUG: Fix package generation for Mageia.
    * BUG: Choosing directories as extra files to package now works correctly
      for RMP, DEB and TGZ packages.
    * BUG: Remove PREFIX support in autotools package generation. Currently
      it's buggy AND useless.
    * BUG: ArchLinux package now support extra dependencies.
    * BUG: Fix a crash when opening a form with a tabstrip, when a "move tab
      button" is pressed.
    * BUG: Generation of Archlinux binaries packages in the IDE doesn't check
      dependencies anymore, so they can be built with SVN version also.
    * NEW: Use a TabPanel instead of a TabStrip to draw the Report form.
    * NEW: Make the grid visible in all form families, and align it correctly
      even in a Report form.
    * NEW: Undo & Redo were implemented in the form editor.
    * NEW: The port can be defined now in the connection dialog.
    * NEW: Global editor position history. Two new buttons and menu entries
      allow to move forward and backward into that history.
    * NEW: Add a history popup menu.
    * NEW: Support for the new Invert arrangement property.
    * NEW: WebPage support.
    * NEW: Add gb.gsl to the list of components.
    * NEW: Update Catalan translation.
    * NEW: Traditional Chinese translation made by Timothy Lin.
    * NEW: Libraries now can have requirements exactly like components. This is
      taken into account by the project property dialog.
    * NEW: Make project creation dialog and project 'Save As' dialog less
      difficult to understand.
    * NEW: Take property synonymous into account.
    * NEW: Less flickering when displaying project items.
    * NEW: Update czech translation.
    * NEW: Update logos.
    * NEW: A new panel in the option dialog that allows to define which files
      must be ignored when creating a source package or an installation
      package.
    * NEW: Update error messages.
    * NEW: Font size options has been renamed as "Default font size" and "Small
      font size". The small font size is now used for all toolbars.
    * NEW: The help browser proxy can be configured.
    * NEW: The debug window has a button to switch between "normal view" and
      "symbol view". In "normal view", array and collection contents are
      displayed. If the object is not an array or a collection, then all
      non-hidden symbols are displayed. In "symbol view", all objects symbols
      are displayed, whatever the object type is.
    * NEW: Error messages now can be displayed in normal text editors.
    * NEW: Update Brazilian Portuguese translation.
    * NEW: Update the alternate background color of all themes.
    * NEW: Support for both Mageia and Mandriva.
    * NEW: Packager configuration is now saved with a new format in the
      ".project" file. The old format is automatically converted.
    * NEW: Check that packagers extra files really exist in the project
      directory.
    * NEW: Packager configuration is now saved even for unchecked target
      systems.
    * NEW: Now you can select directories as packager extra files.
    * NEW: Update french translation.
    * NEW: Update czech translation
    * NEW: Swedish translation updated by Emil Lenngren.
    * NEW: Archlinux packages support dependency against a specific component
      version. Other packages use the old behaviour.
    * NEW: Archlinux packages now support installation of extra files.

    [WIKI CGI SCRIPT]
    * NEW: @index now can sort pages by ignoring a prefix but by displaying the
      full page title anyway in the index.

    [EXAMPLES]
    * BUG: Add lost files ...
    * BUG: Fix the DragNDrop example.
    * BUG: Add gb.form to the dependencies of the PictureDatabase example.
    * NEW: Port can be defined in the Database example.
    * NEW: New MineSweeper example made by Timothy Lin and slightly modified by
      me.

    [BENCHMARKS]
    * NEW: New N-Poly benchmarks.
    * NEW: All benchmarks times were updated on the wiki.

    [INTERPRETER]
    * BUG: EXEC / SHELL ... FOR INPUT now work correctly when OUTPUT is not
      specified, and there is no true terminal to get the data that is not
      redirected.
    * BUG: Missing return values are correctly catched in operators now.
    * BUG: Terminal emulation now does not automatically convert NL to CR+NL.
    * BUG: Fix the declaration of custom array classes.
    * BUG: Fix IIf() when its arguments have different types.
    * BUG: Fix IIf() when the returned values are objects.
    * BUG: Fix bits manipulation routines on Short values.
    * BUG: Fix inline array operator when mixing objects and standard
      datatypes.
    * BUG: Fix the Param array accessor, that returns a specific extra argument
      from its index.
    * BUG: Float and Single constants are now supported in native classes.
    * BUG: Make date formatting more consistent when the date part or the time
      part is null.
    * BUG: The time part of a formatted date is never automatically removed
      anymore.
    * BUG: Object.Call() returns its value correctly now.
    * BUG: Fix translatable string constants inheritance.
    * BUG: Fix enumeration abortion.
    * BUG: Convert the return value of a native function to a variant
      automatically only if the function call is done by a "CALL" bytecode.
      Consequently the gb.signal component works again.
    * BUG: Constructors that receive too many arguments now correctly raise an
      error.
    * BUG: CATCH and FINALLY correctly restore the stack pointer. Without that,
      it is possible to use more stack than possible and to crash the
      interpreter.
    * BUG: Correctly release the stack when dealing with a CATCH / FINALLY
      instruction.
    * BUG: Destructors now can safely raise errors. If these errors are
      ignored, the object is released anyway.
    * BUG: LINE INPUT does not try to incorrectly release its stream argument
      anymore when there is no stream argument.
    * BUG: Adding years with DateAdd() to 29 Feb now switch to 28 Feb not to
      create invalid dates if the result is not in a leap year.
    * BUG: Fix structure field padding.
    * BUG: Fix String.Mid$() when the third argument goes after the string
      length.
    * BUG: Fix String.Left$() when the second argument is greater than the
      string length.
    * BUG: INPUT does not leak memory anymore.
    * BUG: RDir() now browse directories recursively even if the filter
      argument is gb.File.
    * BUG: IIf() and [...] do not accept non-value datatypes (Class and
      Function).
    * BUG: In memory checking routines, take previous SIGSEGV and SIGBUS signal
      handlers into account now.
    * NEW: Define a minimum and maximum bytecode version that the interpreter
      can handle.
    * NEW: New error message when a child process cannot be run for any reason.
    * NEW: System.FullVersion now returns the full version string, with major,
      minor and release.
    * NEW: Chmod, Chown and Chgrp were implemented.
    * NEW: Stat.Auth is a new property that returns the file mode as a string,
      using the format of the 'chmod' shell command.
    * NEW: Rmdir raises a specific 'Directory is not empty' error now, when
      trying to remove a non-empty directory.
    * NEW: The Html$() function now converts unicode non-breaking space (code
      160) in a "&amp;nbsp;" entity.
    * NEW: IsNan() is a new function that returns if a floating point value is
      not a number.
    * NEW: IsInf() is a new function that returns +1 if a floating point value
      is +Inf, -1 if it is -Inf, and 0 if it is a normal number.
    * NEW: Swap$() is a new function that swaps a string.
    * NEW: The MkBool$(), MkShort$(), MkInt$()... functions come back!
    * NEW: System.Shell is a new property that allows to define the shell used
      by the Shell instruction. By default, this is '/bin/sh'.
    * NEW: Loading a library does not load its dependencies automatically
      anymore. Now they behave like components, and the IDE will have to
      compute the dependencies.
    * NEW: Formatting a date with gb.GeneralDate now always prints the time.
    * NEW: GB.RaiseBegin() and GB.RaiseEnd() are two new intepreter APIs that
      allow to define a callback that will be called if an exception is raised
      during a call to GB.Raise().
    * NEW: 't' and 'tt' are two new date formatting patterns that display the
      timezone.
    * NEW: New GOSUB instruction. You return from a GOSUB with the RETURN
      instruction alone. Consequently, you cannot exit from a 'SUB' with it if
      there is a pending GOSUB. The GOSUB stack is only limited by the
      available memory.
    * NEW: INPUT now only read strings. It does not convert the read string
      with Val() anymore.
    * NEW: The debugger now can display collection-like objects. An object can
      be displayed like a collection if it has a Count property, is enumerable,
      has a _get special method taking a string, and has a Key property that
      returns the key of the last enumerated element.
    * OPT: Optimize IIf() when its two last arguments have the same datatype.
    * OPT: A little optimization in Space$(), Upper$() and Lower$().
    * OPT: EXEC / SHELL ... TO does not return the process output through a
      temporary string that will be freed later. If the string is big, then
      the memory is retained longer than necessary.
    * OPT: Use mmap() to allocated the stack, not malloc(). Consequently,
      calling functions recursively are now very fast.
    * OPT: A little optimization in LINE INPUT.

    [COMPILER]
    * BUG: Don't print a line number greater than the number of lines in the
      compiled file when displaying an error message.
    * NEW: Chmod <path> To <mode> was implemented. <mode> is a string having
      the same format as the 'chmod' shell command.
    * NEW: Chown <path> To <user> was implemented. <user> is the name of the
      user as defined in the /etc/passwd file.
    * NEW: Chgrp <path> To <group> was implemented. <user> is the name of the
      group as defined in the /etc/group file.
    * NEW: Start supporting WebPage.
    * NEW: +Inf and -Inf are two new keywords for representing the
      corresponding special floating values.
    * NEW: A property now can has up to four different names. The syntax is:
      "Property Name [ , Synonymous1, ..., Synonymous3 ] As Datatype".
    * NEW: Raise an error now when using TRY with GOTO, BREAK, CONTINUE or
      STOP.
    * NEW: New GOSUB instruction.
    * NEW: New FAST keyword.
    * NEW: Support of WebPage compilation.

    [ARCHIVER]
    * NEW: Put the '.component' file inside archives, so that the IDE can
      extract libraries requirements from the executable.

    [SCRIPTER]
    * BUG: Fix compilation of inline class declarations.

    [GB.DB]
    * BUG: Table.Type property now correctly handle null table types.
    * BUG: Result.Update() now does not emit an incorrect request when the
      result has not been modified. It just does nothing.
    * NEW: Support for port in a connection defined in the IDE.
    * NEW: Connection.Handle is a new property that returns the
      database-specific internal handle.

    [GB.DB.FORM]
    * BUG: The DataBrowser and DataView controls have been fixed. There is only
      one problem to fix that depends on a gb.gtk bug.
    * BUG: Fix a crash in DataView when it has no current row.
    * BUG: DataBrowser: Clicking on the delete button does not delete two
      records anymore.
    * BUG: DataBrowser: Saving a new record now correctly takes into account
      the currently edited field.
    * NEW: DataBrowser.Grid is a new property to define the grid visibility.

    [GB.DB.SQLITE3]
    * BUG: Void blobs are correctly reset when enumerating a Result.

    [GB.DBUS]
    * BUG: Fix DBus method call when the method returns nothing. If there is an
      error, it is correctly raised.
    * BUG: Fix memory leaks in DBus error management.
    * BUG: Fix DBusObserver matching rules handling.

    [GB.DEBUG]
    * NEW: The debugger now can display collection-like objects. An object can
      be displayed like a collection if it has a Count property, is enumerable,
      has a _get special method taking a string, and has a Key property that
      returns the key of the last enumerated element.

    [GB.DESKTOP]
    * BUG: Desktop.Width and Desktop.Height are not overridden anymore.

    [GB.DRAW]
    * BUG: Accessing a temporarily closed drawing device now raises an error
      instead of crashing.
    * BUG: Rect class can be used as a fonction correctly now.
    * BUG: Setting Draw.Font to NULL does not crash anymore, and raise an error
      instead.

    [GB.EVAL]
    * BUG: Fix analyze of non-terminated strings and quoted symbols that could
      crash.

    [GB.EVAL.HIGHLIGHT]
    * BUG: 'undefined' is a javascript keyword.
    * NEW: Support for server-side comment syntax in WebPage highlight routine.
    * NEW: Update WebPage highlighting, and handle the new syntaxes.

    [GB.FORM]
    * BUG: The last pixels of a TabPanel button are clickable now.
    * BUG: Fix ValueBox in design mode.
    * BUG: Fix ListContainer control.
    * BUG: Fix ToolPanel Index value when decreasing the Count property.
    * BUG: The TableView editing field is now never larger than the TableView
      contents.
    * BUG: ButtonBox background is correctly drawn with gb.gtk.
    * NEW: TabPanel buttons take a bit less space.
    * NEW: Little fix in TabPanel button layout.
    * NEW: FileChooser.ShowFile is a new property to hide or show the textbox
      that displays the file name.
    * NEW: FileChooser got a new Margin property, that adds a margin around the
      FileChooser controls when set.
    * NEW: Update Catalan translation.
    * NEW: Wizard: Remove padding around contents when the wizard has no
      border.
    * NEW: Make a GridView control entirely in Gambas. Contrary to its native
      implementation, it can handle millions of lines without eating all
      memory.
    * NEW: GridView.ShowCursor is a new property that displays a light cursor
      around the current cell when set.
    * NEW: IconPanel now uses a GridView and not an IconView anymore.
    * NEW: GridView.Rows.Select and Unselect methods now selects (or unselects)
      one line if their second argument is omitted.
    * NEW: GridView: Setting the column width to -1 make it fit its contents.
    * NEW: GridView: Double-clicking on the right limit of a column make it
      fit its contents.
    * NEW: The stock icon named "earth" has been renamed as "internet".
    * NEW: GridView[].EnsureVisible now keeps the left part of the cell always
      visible.
    * NEW: GridView columns have two new properties: Alignment and Background.
    * NEW: GridView.Sort and GridView.Ascending are two new properties to
      define which column shows a sort symbol.
    * NEW: GridView.Sorted is a new property to automatically handle column
      clicks and display the sort symbol.
    * NEW: You can now find IconView items by directly typing their name while
      the control has the focus.
    * NEW: Use a mix between Color.LightBackground and Color.TextBackground form
      the Balloon background.

    [GB.FORM.DIALOG]
    * NEW: Take the new Dialog.ShowHidden property into account.

    [GB.FORM.MDI]
    * BUG: Fix ToolBar behaviour when none of its children has an action.

    [GB.FORM.STOCK]
    * BUG: Do not require gb.gtk, so that compilation does not fail if gb.gtk
      is not available.

    [GB.GSL]
    * NEW: New component made by Randall Morgan that will provide an interface
      to the GNU Scientific Library. The basic math functions are mostly
      complete as well as the basic complex number functions.

    [GB.GTK]
    * BUG: Stopping a file descriptor watch now correctly checks if the event
      loop must be exited.
    * BUG: Fix Cached DrawingArea having a border.
    * BUG: Make gb.gtk compile with GTK+ versions older than 2.18.
    * BUG: Correctly handle GotFocus and LostFocus events for proxies.
    * BUG: Now raise an error when using text-box methods on read-only
      combo-boxes.
    * BUG: Dialog.SelectDirectory() now correctly takes into account
      Dialog.Path.
    * BUG: Fix Dialog.ShowHidden.
    * BUG: The TreeView/ListView/ColumnView Click event now should behave the
      same way as in gb.qt4.
    * BUG: The inner container of a UserContainer is now automatically its
      proxy control.
    * BUG: If the DrawingArea Draw event handler raises an error, then the
      interpreter should not crash anymore.
    * BUG: Mouse events are now cancelable, like in gb.qt4, so that proxies can
      prevent their propagation.
    * BUG: Draw checked menu items correctly.
    * BUG: GTK+ callbacks must return a gboolean, not a bool. The C++ compiler
      does not compile the same thing in both cases!
    * BUG: Remove some debugging messages.
    * BUG: Handle GTK+ events, but not Gambas posted routines when setting the
      application busy cursor.
    * BUG: Fix container children management.
    * BUG: Fix TabStrip management.
    * BUG: Try to handle the Menu event the same way as in gb.qt4.
    * BUG: Do not try to change the background color of menus. It breaks GTK+
      widget style like Ambiance.
    * BUG: The print output file name is correctly unescaped now.
    * BUG: Try to handle Leave/Enter events the same way as in gb.qt4.
    * NEW: GTK+ 2.16 is now required.
    * NEW: Containers now have a new Invert property, that reverts horizontal
      arrangements.
    * NEW: Dialog.ShowHidden is a new property to show or hide hidden files. It
      does not work on GTK+ at the moment. Is it a GTK+ bug?
    * NEW: Control.NoTabFocus is a new property that prevents a control from
      being in the TAB key focus chain.
    * NEW: Font.Copy() is a new method to copy a font object.
    * NEW: GTK+ GridView has been removed.
    * NEW: The Container Insert event has been renamed as NewChild.
    * NEW: Align.IsTop(), Align.IsBottom(), Align.IsMiddle(), Align.IsLeft(),
      Align.IsRight() and Align.Center() are new methods that allow to know the
      direction of an alignment according to the current language direction.

    [GB.IMAGE]
    * BUG: Image.Colorize() now takes the color brightness into account.

    [GB.NET.CURL]
    * BUG: Fix allocation of initial FtpClient URL.

    [GB.QT4]
    * BUG: Correctly handle GotFocus and LostFocus events for proxies.
    * BUG: Correctly handle Menu events for proxies.
    * BUG: DrawingArea: Visible property now works correctly when the Cached
      property is set.
    * BUG: DrawingArea: Fix crash when setting the Cached property to True,
      then to False.
    * BUG: Drag & drop is allowed when the DragMove *or* the Drop events are
      handled.
    * BUG: The inner container of a UserContainer is now automatically its
      proxy control.
    * BUG: If the DrawingArea Draw event handler raises an error, then the
      interpreter should not crash anymore.
    * BUG: Fix Draw.RichTextWidth() by rounding the internal floating point
      width up.
    * BUG: Do not crash when UserControl or UserContainer container is deleted.
    * BUG: Delete the Qt4 application class in component exit routine,
      otherwise Qt 4.8 seems to crash sometimes.
    * BUG: If a form is defined as being not visible, then using it as a
      startup form won't show it.
    * BUG: Fix ToolButton text and picture alignment.
    * BUG: Enter and Leave events are now correctly generated from a window
      that has been opened with the ShowPopup() method.
    * BUG: Workaround an Oxygen bug with ScrollView borders.
    * BUG: Setting ScrollView.Border correctly refreshes the scrollbars now.
    * BUG: Fix cached DrawingArea updates.
    * BUG: Fix the Enter/Leave events management so that Enter events are
      correctly generated when a control is destroyed.
    * NEW: Containers now have a new Invert property, that reverts horizontal
      arrangements.
    * NEW: Dialog.ShowHidden is a new property to show or hide hidden files.
    * NEW: Control.NoTabFocus is a new property that prevents a control from
      being in the TAB key focus chain.
    * NEW: Font.Copy() is a new method to copy a font object.
    * NEW: Qt4 GridView has been removed.
    * NEW: The Container Insert event has been renamed as NewChild.
    * NEW: Align.IsTop(), Align.IsBottom(), Align.IsMiddle(), Align.IsLeft(),
      Align.IsRight() and Align.Center() are new methods that allow to know the
      direction of an alignment according to the current language direction.
    * NEW: Do not display translation warning anymore when choosing the "C"
      translation. Just uninstall the current translation (if any) silently.
    * OPT: Make part of the internal widget structure optional to save a bit of
      memory when rarely used properties are not set.

    [GB.QT4.EXT]
    * BUG: Disable kerning when drawing text in Editor.
    * BUG: Editor: Fix cursor management when the file end is folded.
    * BUG: Editor cursor is ensured to be visible when it is visible, not when
      it has just the focus.
    * BUG: Fix an uninitialized field in Editor internal GLine class.
    * BUG: Fix bad interactions between highlighting and undo management.
    * NEW: Make bold text more readable in Editor.
    * NEW: Editor: Do not highlight the current line when losing the focus.

    [GB.QT4.WEBKIT]
    * NEW: WebSettings.DefaultProxy is a new constant for using the default
      proxy configuration.

    [GB.SIGNAL]
    * BUG: Fix compilation on Windows/Cygwin.

    [GB.V4L]
    * NEW: Compile with success on FreeBSD.

    [GB.VB]
    * BUG: Fix compilation on Windows/Cygwin.

    [GB.WEB]
    * BUG: Setting a Request value to NULL now works as expected.
    * NEW: Url.Encode() and Url.Decode() now replace CGI.Encode() and
      CGI.Decode().
    * NEW: Add two new static methods, URL.SetQuery() and URL.UnsetQuery() to
      set and unset a field inside the URL query.
    * NEW: WebPage support is official.
    * NEW: WebPage.Buffered is a new property to tell the generated HTML to be
      buffered  by using the Response.Buffered property.

## Requirements

To compile Gambas, you must install the following libraries on your system :

Component | Requirements
--- | ---
Compilation | `gcc` `g++` `automake` `autoconf` `libtool > 2.4` (See requirements on autotools versions below)
Interpreter | `libffi`
`gb.compress.bzlib2` | `libbz2.so`
`gb.compress.zlib` | `libz.so`
`gb.cairo` | `cairo`
`gb.crypt` | `libcrypt.so`
`gb.db.mysql` | `libmysqlclient.so`, `libz.so`
`gb.db.odbc` | `libodbc.so`
`gb.db.postgresql` | `libpq.so`
`gb.db.sqlite2` | `libsqlite.so`
`gb.db.sqlite3` | `libsqlite3.so`
`gb.desktop` | `libXtst.so`
`gb.gsl` | `libgsl.so` `libgslcblas.so`
`gb.gtk` | All GTK+ libraries >= 2.14 `librsvg2.so` `cairo`
`gb.image.io` | `gdk-pixbuf`
`gb.image.imlib` | `imlib`
`gb.net.curl` | `libcurl.so`
`gb.opengl` `gb.opengl.glsl` | `libGL.so`, `libGLEW.so`
`gb.opengl.glu` | `libGLU.so`
`gb.pcre` | `libpcre.so`
`gb.pdf` | `libpoppler.so`
`gb.qt4` `gb.qt4.ext` `gb.qt4.opengl` `gb.qt4.webkit` | All qt 4 libraries >= Qt 4.5
`gb.sdl` | `libSDL.so`, `libSDL_ttf.so`, `libGL.so`, `libGLEW.so`
`gb.sdl.sound` | `libSDL.so`, `libSDL_mixer.so`
`gb.v4l` | `libjpeg.so`, `libpng.so`,Video4Linux >= 2.0
`gb.xml` | `libxml-2.0`
`gb.xml.xslt` | `libxslt`

And do not forget to install all related development packages!

Try to always use a recent version of these libraries.

In order to compile the development environment, you have to compile the following components:

- gb.db

- gb.db.form

- gb.debug

- gb.desktop

- gb.eval

- gb.eval.highlight

- gb.form

- gb.form.dialog

- gb.form.mdi

- gb.image

- gb.image.effect

- gb.qt4

- gb.qt4.ext

- gb.qt4.webkit

- gb.settings

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 on Ubuntu 11.10:

- `automake` 1.11.1

- `autoconf` 2.68

- `libtool` 2.4

Compiling with older version may or may not work!

## Compilation & Installation

### Check installation

First, check that you installed all the needed libraries, and especially all the development packages.

Do not forget to look at the Compilation & Installation page. Maybe you will find important information specific to your distribution.

### Source package configuration

When you are sure that everything is installed, type the following magic sentences in a shell.

`'$'` represents your shell prompt, and `'...'` are the messages printed during the configuration and compilation.

First, type that to create the configuration scripts.

    $ ./reconf-all

Then type that to analyze the current system and configure the package:

    $ ./configure -C
    ...

If a library or a development package is missing, then you will be warned that some components are disabled.

There are more 'configure' specific explanations in the `INSTALL` file located in the top-level source directory. I invite you to read them.

### Compilation

If everything is configured without error, then run this command to compile the program:

    $ make
    ...

### Installation

If everything compiles without error, then enter this command to install everything:

You must be `root` to install Gambas on your system.

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

or

    $ sudo make install
    Password: <Type your password here>
    ...

### Troubleshooting

If you did several successive compilations, after having updated the source from the subversion repository for example, and if something fails during all this process, you can try to "reconfigure" the configuration scripts by typing the following command:

    $ ./reconf-all

Then you can run `./configure -C` again

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

    $ ( ./configure -C; 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.

### Running Gambas

If everything was fine, type "gambas3" to run the development environment.

Enjoy it !

### See also

- Compilation & Installation