Packaging specifications for Gambas version 3.19

REVISION: 2024-11-17

Gambas binary packages must have the following names and contents:

The runtime package

This package includes the Gambas interpreter needed to run Gambas applications and various components that have no other dependency than the interpreter.

It contains:
  • The interpreter: gbx3.

  • The symbolic link on gbx3: gbr3.

  • The man pages gbx3.1 and gbr3.1.

  • The internal component description: gb.component, gb.info and gb.list.

  • The readme files, TODO files, and so on.

And the following components:
  • The gb.debug component: gb.debug.info, gb.debug.list, gb.debug.component, gb.debug.so.*, gb.debug.la.

  • The gb.eval component: gb.eval.info, gb.eval.list, gb.eval.component, gb.eval.so.*, gb.eval.la.

  • The gb.geom hidden component: gb.geom.info, gb.geom.list, gb.geom.component, gb.geom.so.*, gb.geom.la.

  • The gb.draw hidden component: gb.draw.info, gb.draw.list, gb.draw.so.*, gb.draw.la.

  • The gb.gui component: gb.gui.info, gb.gui.list, gb.gui.component, gb.gui.so.*, gb.gui.la.

  • The gb.gui.base hidden component: gb.gui.base.info, gb.gui.base.list, gb.gui.base.gambas.

  • The gb.gui.opengl component: gb.gui.opengl.info, gb.gui.opengl.list, gb.gui.opengl.component, gb.gui.opengl.so.*, gb.gui.opengl.la.

  • The gb.gui.qt component: gb.gui.qt.info, gb.gui.qt.list, gb.gui.qt.component, gb.gui.qt.so.*, gb.gui.qt.la.

  • The gb.gui.qt.ext component: gb.gui.qt.ext.info, gb.gui.qt.ext.list, gb.gui.qt.ext.component, gb.gui.qt.ext.so.*, gb.gui.qt.ext.la.

  • The gb.gui.qt.opengl component: gb.gui.qt.opengl.info, gb.gui.qt.opengl.list, gb.gui.qt.opengl.component, gb.gui.qt.opengl.so.*, gb.gui.qt.opengl.la.

  • The gb.gui.qt.webkit component: gb.gui.qt.webkit.info, gb.gui.qt.webkit.list, gb.gui.qt.webkit.component, gb.gui.qt.webkit.so.*, gb.gui.qt.webkit.la.

  • The gb.gui.trayicon component: gb.gui.trayicon.info, gb.gui.trayicon.list, gb.gui.trayicon.component, gb.gui.trayicon.so.*, gb.gui.trayicon.la.

  • The gb.gui.webview component: gb.gui.webview.info, gb.gui.webview.list, gb.gui.webview.component, gb.gui.webview.so.*, gb.gui.webview.la.

  • The gb.hash component: gb.hash.info, gb.hash.list, gb.hash.component, gb.hash.so.*, gb.hash.la.

  • The gb.jit component: gb.jit.info, gb.jit.list, gb.jit.component, gb.jit.so.*, gb.jit.la, gb.jit.gambas.

  • The gb.test component: gb.test.info, gb.test.list, gb.test.component, gb.test.gambas.

Its name must be gambas3-runtime.

This package must register the application/x-gambas3 mime type as specified by the application-x-gambas3.xml file and the application-x-gambas3.png icon.

Note that gb.la, gb.so, gb.so.0 and gb.so.0.0.0 do not need to be distributed. They are temporary files used for generating gb.info and gb.list only.

The components included in this package have no dependency on any other components.

The gbr3 symbolic link MUST be in the PATH, otherwise executables will not work.

gb.gui.base is a component written in Gambas that cannot actually be used on its own. It implements many GUI controls for GUI components, and it is explicitly loaded by them (like gb.draw).

The gambas3-gb-jit package (The Gambas JIT compiler) needs a compiler to work: either gcc or clang.

The development tools package

This package includes all tools needed to compile Gambas projects without having to install the complete development environment.

It contains:
  • The compiler: gbc3.

  • The archiver: gba3.

  • The informer: gbi3.

  • The help generator: gbh3.

  • The man pages gbc3.1, gba3.1, gbi3.1 and gbr3.1.

Its name must be gambas3-dev-tools.

This package was previously named gambas3-dev or gambas3-devel.

This was a mistake, as these names are used in various distributions for packages that allows to develop Gambas, not to develop with Gambas.

The scripter package

This package includes the scripter program that allows to write script files in Gambas and to serve Gambas webpages when run with another name.

It contains:
  • The scripter: gbs3.gambas.

  • The symbolic link on it: gbs3.

  • Another symbolic link on it with a specific name: gbw3.

  • The man pages gbs3.1 and gbw3.1.

Its name must be gambas3-scripter.

It depends on the following Gambas packages:
  • gambas3-runtime.

  • gambas3-dev-tools.

  • gambas3-gb-pcre.

This package must register the application/x-gambasscript mime type as specified by the application-x-gambasscript.xml file and the application-x-gambasscript.png icon.

The gbs3 symbolic link MUST be in the PATH, otherwise scripts will not work.

The GUI package

This package is a virtual package that must depends on either:
  • gambas3-gb-qt4.

  • gambas3-gb-qt5.

  • gambas3-gb-gtk.

  • gambas3-gb-gtk3.

It is used as a dependency for packages that requires any GUI package (like gambas3-gb-form).

Its name must be gambas3-gui.

The component packages

Each gambas component must have its own package.

The package of a component contains:

  • The shared library files: gb.XXX.la, gb.XXX.so, gb.XXX.so.0, gb.XXX.so.0.0.0.

  • The component file: gb.XXX.component.

  • The information file: gb.XXX.info and gb.XXX.list.

  • Sometimes a part written in Gambas: gb.XXX.gambas.

...where gb.XXX is the name of the component

Then name of a component package MUST BE gambas3-gb-XXX where gb-XXX is the name of the component, the point being replaced by a minus sign.

For example, the gb.qt4 component package name is gambas3-gb-qt4. It must include:
  • gb.qt4.la

  • gb.qt4.so

  • gb.qt4.so.0

  • gb.qt4.so.0.0.0

  • gb.qt4.component

  • gb.qt4.gambas

  • gb.qt4.info

  • gb.qt4.list

Some component are entirely written in Gambas, i.e. they have only a Gambas part. These components are located in the comp directory of the source archive.

You must follow the previous rules for these components, except that there is no shared library files inside.

If a component is written in Gambas, or has a Gambas part, then it must depend on gambas3-runtime.

Note that gb.debug, gb.eval, gb.draw, gb.geom, gb.gui, gb.gui.qt, gb.gui.qt.webkit, gb.gui.base and gb.gui.opengl do not have their own package, as they are distributed with the gambas3-runtime package.

The development environment package

This package includes the complete Gambas Development Environment.

It contains:
  • The development environment: gambas3.gambas.

  • The symbolic link on it: gambas3.

  • The project templates needed to create new projects. They are all gambas projects located in /app/template in the source directory, and installed in /usr/share/gambas3/template.

  • The man page gambas3.1.

It depends on the following Gambas packages:
  • gambas3-runtime.

  • gambas3-dev-tools.

  • The packages of the components needed by the IDE:
    • gb.clipper

    • gb.db

    • gb.db.form

    • gb.debug

    • gb.desktop

    • gb.desktop.x11

    • gb.eval

    • gb.highlight

    • gb.form

    • gb.form.dialog

    • gb.form.editor

    • gb.form.mdi

    • gb.form.print

    • gb.form.stock

    • gb.form.terminal

    • gb.image

    • gb.markdown

    • gb.net

    • gb.net.curl

    • gb.settings

    • gb.signal

    • gb.term

    • gb.util

Moreover you must add dependencies on either:
  • gambas3-gb-qt4-webview.

  • gambas3-gb-qt5-webview.

  • or gambas3-gb-gtk3-webview.

You MAY make this package depend on all Gambas components, so that they are all installed, but this is not recommended.

Its name must be gambas3-ide.

The IDE relies on the following external tools:
  • The GNU translation tools for translating a project.

  • The rpm tools for creating RPM packages.

  • The deb tools for creating DEB packages.

  • The ARCH tool for creating ARCH packages.

  • The tar & gzip tools for creating *.tar.gz archives.

  • The wget utility for downloading offline help from the wiki.

And optionally on these tools:
  • pngquant for PNG compression optimizations.

  • translate-shell for automatic translation.

  • git for project version control.

  • subversion for project version control.

So you must add the dependencies on the packages that provide these tools. The name of these packages depends on the distribution.

Package list

Package Depends on these packages
gambas3 gambas3-dev-tools
gambas3-gui
gambas3-ide
gambas3-runtime
gambas3-scripter
all component packages
gambas3-dev-tools
gambas3-gui gambas3-gb-gtk
OR gambas3-gb-gtk3
OR gambas3-gb-qt4
OR gambas3-gb-qt5
gambas3-ide gambas3-dev-tools
gambas3-runtime
gambas3-gb-clipper
gambas3-gb-db
gambas3-gb-db-form
gambas3-gb-desktop
gambas3-gb-form
gambas3-gb-form-dialog
gambas3-gb-form-editor
gambas3-gb-form-htmlview
gambas3-gb-form-mdi
gambas3-gb-form-print
gambas3-gb-form-stock
gambas3-gb-form-terminal
gambas3-gb-highlight
gambas3-gb-image
gambas3-gb-markdown
gambas3-gb-net
gambas3-gb-net-curl
gambas3-gb-pcre
gambas3-gb-settings
gambas3-gb-signal
gambas3-gb-term
gambas3-gb-util
gambas3-gb-util-web
gambas3-runtime
gambas3-scripter gambas3-dev-tools
gambas3-runtime
gambas3-gb-pcre
gambas3-gb-args
gambas3-gb-cairo gambas3-gb-image
gambas3-gb-chart gambas3-gb-form
gambas3-gb-clipper
gambas3-gb-complex
gambas3-gb-compress
gambas3-gb-compress-bzlib2 gambas3-gb-compress
gambas3-gb-compress-zlib gambas3-gb-compress
gambas3-gb-compress-zstd gambas3-gb-compress
gambas3-gb-crypt
gambas3-gb-data
gambas3-gb-db
gambas3-gb-db-form gambas3-gb-db
gambas3-gb-form
gambas3-gb-db-mysql gambas3-gb-db
gambas3-gb-db-odbc gambas3-gb-db
gambas3-gb-db-postgresql gambas3-gb-db
gambas3-gb-db-sqlite2 gambas3-gb-db
gambas3-gb-db-sqlite3 gambas3-gb-db
gambas3-gb-dbus
gambas3-gb-dbus-trayicon gambas3-gb-dbus
gambas3-gb-image
gambas3-gb-desktop gambas3-gb-image
gambas3-gb-desktop-gnome-keyring gambas3-gb-desktop
gambas3-gb-desktop-x11 gambas3-gb-desktop
gambas3-gb-image
gambas3-gb-eval-highlight
gambas3-gb-form gambas3-gui
gambas3-gb-form-dialog gambas3-gb-form
gambas3-gb-form-editor gambas3-gb-highlight
gambas3-gb-form
gambas3-gb-util
gambas3-gb-form-htmlview
gambas3-gui
gambas3-gb-form-mdi gambas3-gb-form
gambas3-gb-settings
gambas3-gb-form-print gambas3-gb-form
gambas3-gb-form-stock
gambas3-gb-form-terminal gambas3-gui
gambas3-gb-term
gambas3-gb-gmp
gambas3-gb-gsl
gambas3-gb-gtk gambas3-gb-image
gambas3-gb-gtk-opengl gambas3-gb-gtk
gambas3-gb-opengl
gambas3-gb-gtk3 gambas3-gb-image
gambas3-gb-gtk3-wayland
OR gambas3-gb-gtk3-x11
gambas3-gb-gtk3-opengl gambas3-gb-gtk3
gambas3-gb-opengl
gambas3-gb-gtk3-wayland gambas3-gb-gtk3
gambas3-gb-gtk3-webview gambas3-gb-gtk3
gambas3-gb-gtk3-x11 gambas3-gb-gtk3
gambas3-gb-highlight gambas3-gb-image
gambas3-gb-pcre
gambas3-gb-httpd
gambas3-gb-image
gambas3-gb-image-effect gambas3-gb-image
gambas3-gb-image-imlib gambas3-gb-image
gambas3-gb-image-io gambas3-gb-image
gambas3-gb-inotify
gambas3-gb-libxml
gambas3-gb-logging
gambas3-gb-map gambas3-gb-net
gambas3-gb-net-curl
gambas3-gb-markdown
gambas3-gb-media gambas3-gb-image
gambas3-gb-media-form gambas3-gui
gambas3-gb-media
gambas3-gb-memcached gambas3-gb-net
gambas3-gb-mime
gambas3-gb-mysql gambas3-gb-db
gambas3-gb-db-mysql
gambas3-gb-ncurses
gambas3-gb-net
gambas3-gb-net-curl gambas3-gb-net
gambas3-gb-net-pop3 gambas3-gb-mime
gambas3-gb-net
gambas3-gb-net-smtp gambas3-gb-net
gambas3-gb-openal
gambas3-gb-opengl gambas3-gb-image
gambas3-gb-opengl-glsl gambas3-gb-opengl
gambas3-gb-opengl-glu gambas3-gb-opengl
gambas3-gb-opengl-sge gambas3-gb-opengl
gambas3-gb-openssl
gambas3-gb-option
gambas3-gb-pcre
gambas3-gb-pdf gambas3-gb-image
gambas3-gb-poppler gambas3-gb-image
gambas3-gb-qt4 gambas3-gb-image
gambas3-gb-qt4-ext gambas3-gb-qt4
gambas3-gb-qt4-opengl gambas3-gb-opengl
gambas3-gb-qt4
gambas3-gb-qt4-webkit gambas3-gb-qt4
gambas3-gb-qt4-webview gambas3-gb-qt4
gambas3-gb-qt5 gambas3-gb-image
gambas3-gb-qt5-wayland
OR gambas3-gb-qt5-x11
gambas3-gb-qt5-ext gambas3-gb-qt5
gambas3-gb-qt5-opengl gambas3-gb-opengl
gambas3-gb-qt5
gambas3-gb-qt5-wayland gambas3-gb-qt5
gambas3-gb-qt5-webkit gambas3-gb-qt5
gambas3-gb-qt5-webview gambas3-gb-qt5
gambas3-gb-qt5-x11 gambas3-gb-qt5
gambas3-gb-report gambas3-gb-form
gambas3-gb-report2 gambas3-gb-form
gambas3-gb-scanner
gambas3-gb-sdl gambas3-gb-image
gambas3-gb-image-io
gambas3-gb-sdl-sound
gambas3-gb-sdl2 gambas3-gb-image
gambas3-gb-sdl2-audio
gambas3-gb-settings
gambas3-gb-signal
gambas3-gb-term
gambas3-gb-term-form gambas3-gb-term
gambas3-gb-util
gambas3-gb-util-web
gambas3-gb-v4l gambas3-gb-image
gambas3-gb-vb
gambas3-gb-web
gambas3-gb-web-feed gambas3-gb-util
gambas3-gb-xml
gambas3-gb-web-form gambas3-gb-util
gambas3-gb-util-web
gambas3-gb-web
gambas3-gb-web-gui gambas3-gb-signal
gambas3-gb-util
gambas3-gb-util-web
gambas3-gb-web
gambas3-gb-xml
gambas3-gb-xml-html gambas3-gb-xml
gambas3-gb-xml-rpc
gambas3-gb-xml-xslt gambas3-gb-xml

If a component is written in Gambas, or has a Gambas part, then it must depend on gambas3-runtime.

Some packages might be not be possible to make on some distro's, because they depend on packages no longer available.
E.g. Debian 11 and later have sqlite2 and qt4 replaced it with sqlite3 and qt5 in their repositories.
Making sqlite2 and qt4 related gambas packages for Debian 11 and later is not longer possible.

You may have a gambas3-debug package to store the debugging information of all previous packages.


Page revisions


Packaging specifications for Gambas version 3.19
- Updated: Nov 16th, 2024 by W. Raets (gbWilly)
- Added gb.jit to 'The runtime package'
- Made a static package list (instead of the development list)
- Removed gb.hash, gb.jit and gb.test as packages from the package list (they are part of runtime)
- Added gb.gui to the table as it is a package that is made
- Added dependency on gb.gui to the respective packages and removed the warning telling to do so
- Added the warning below the table, that partly or complete in Gambas written components need gambas3-runtime as dependency
- Updated Nov 17th, 2024 by W. Raets (gbWilly)
- Renamed gambas3-gb to gambas3 in package list, added dependend packages and put on top of table
- Added gambas3-gui as dependency for gambas3-gb-form-htmlview
- Added gambas3-gtk3-wayland OR gambas3-gtk3-x11 as dependency for gambas3-gtk3
- Added gambas3-qt5-wayland OR gambas3-qt5-x11 as dependency for gambas3-qt5