GBX3(1)

📦
version 3.22.2 · 3 versions
, in arch rolling, fedora 43, ubuntu stonking

💅 GBX3 — the GAMBAS Interpreter, bestie edition 💅

okay so you opened the GBX3(1) manual page and it's giving "cryptic Unix scroll" but honestly? it's just your girl gbx3 and she is SO ready to run your Gambas projects. this is section 1 of the manual, and yes we're doing the whole thing, no skips, no cap. 🎀

✨ NAME ✨

gbx3 — the GAMBAS Interpreter. that's it, that's the name, she's iconic, periodt. 👑

🌸 SYNOPSIS 🌸

gbx3 [options] [<project directory>] [-- <arguments>]
gbx3 -e <expression>

two whole vibes: run a project (with optional args after the --, iykyk), or just yeet a single expression with -e. choose your fighter. 🦋

💖 DESCRIPTION 💖

Gambas is a free development environment built on a Basic interpreter with object extensions — think a lil' mashup of Java(tm) and Visual Basic(tm). and like. the way that you can do SO much with it:

  • quickly design your program GUI with Qt or GTK+ 🎨
  • access database systems like MySQL, PostgreSQL, SQlite or ODBC databases
  • pilot applications with DBus
  • translate your program into many languages 🌈
  • create GStreamer, OpenGL or SDL applications
  • and so on... literally the list does not end bestie

gbx3 is the interpreter itself — the one that lets you execute a Gambas project, or evaluate a Gambas expression (that's the -e option, we love her). 🔥

⭐ OPTIONS ⭐

  • -a <path> — override application path. yes you can just. move the app path. slay.
  • -e — evaluate an expression. one-shot mode, no project needed, iconic behaviour 💅
  • -g — enter debugging mode 🐛
  • -h, --help — display help and exit. the classic "wait what does this do again" button 🫶
  • -H, --httpd — run through an embedded http server 🌐
  • -j — disable just-in-time compiler. (we're going old school, no JIT for you)
  • -k — do not unload shared libraries
  • -L, --license — display license 📜
  • -p <path> — activate profiling and debugging mode
  • -r <path> — redirect standard error output
  • -s <class> — override startup class
  • -t, --trace — dump the position of each executed line of code. yes EVERY line. she's thorough. 🔍
  • -T — list all test modules 🧪
  • -T <tests> — run the specified test modules
  • -V, --version — display version

🧚 ENVIRONMENT VARIABLES 🧚

these are the lil' settings you whisper into the environment before gbx3 wakes up. so many. all of them valid. 🍓

  • GB_DB_DEBUG — set to "1" to enable database component debugging.
  • GB_GUI — define the GUI component that will be loaded by the gb.gui* component family.
  • GB_GUI_DARK_THEME — set to "1" to force dark theme behaviour. (main character energy, always) 🌙
  • GB_GUI_PLATFORM — define the graphic platform used by the GUI components. it can be "x11" or "wayland".
  • GB_HTTPD_DEBUG — set to "1" to enable embedded web server debugging mode.
  • GB_HTTPD_HOST — define the host name used by the embedded web server.
  • GB_HTTPD_PORT — define the port used by the embedded web server.
  • GB_HTTPD_TIMEOUT — define the request timeout of the embedded web server.
  • GB_JIT_CACHE — set to "0" to use the old compilation process that does not use any caching.
  • GB_JIT_CC — define the compiler used by the just-in-time component. "gcc" or "clang" are supported at the moment.
  • GB_JIT_CFLAGS — define the compilation flags used for generating just-in-time code.
  • GB_JIT_DEBUG — set to "1" to enable just-in-time compiler debugging.
  • GB_JIT_ENABLED — set to "0" to disable the just-in-time compiler.
  • GB_JIT_FORCE — set to "1" to ignore the cache and force a new compilation of just-in-time code.
  • GB_JIT_TRACE — set to "1" to display each line executed by the just-in-time compiled code.
  • GB_MEDIA_DEBUG — set to "1" to enable gb.media component debugging.
  • GB_NO_JIT — set to "1" to disable the just-in-time compiler.
  • GB_REVERSE — set to "1" to reverse language direction.
  • GB_STOCK_DEBUG — set to "1" to enable icon theme debugging.
  • GB_WEB_GUI_DEBUG — set to "1" to enable gb.web.gui component debugging.
ok bestie real talk: those "1" / "0" values go in as strings, not as vibes. the quotes are the whole point. 🙈

🌈 AVAILABILITY 🌈

the Gambas website is at: https://gambaswiki.org/website/

the Gambas source code is available at: https://gitlab.com/gambas/gambas/

the documentation about the language is at: https://gambaswiki.org/wiki

💀 REPORTING BUGS 💀

found a bug? report it, queen: http://gambaswiki.org/bugtracker — they want to know, fr fr.

Copyright© Benoît Minisini <benoit.minisini@gambas-basic.org>;

this is free software; see the source for copying conditions. there is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

⚠️ and that NO-warranty thing is not a joke, bestie — it's in all caps in the original for a reason. know what you're running. 💜

and that's the whole page, you're officially fluent in gbx3 🫶✨ this was the GBX3(1) page, sourced and versioned from August 2024 — and honestly? the manual name GBX3(1) lives in your heart now. go run something iconic. 💅🌸

📦 where this page comes from