Tree [30fd65] master /

File Date Author Commit
 contrib 2015-10-01 dkl dkl [c915ea] release: Update manifests again
 doc 2015-10-28 dkl dkl [69d1d6] fbdoc: Fix to work with current PCRE binding
 examples 2015-10-02 dkl dkl [994cd8] examples: Add GTK+ custom widget example
 inc 2015-08-25 dkl dkl [34b46c] inc: Turn many #defines into proper declaration...
 lib 2015-01-06 dkl dkl [201cae] makefile: Add mingw-libs command for copying Mi...
 src 2015-11-01 dkl dkl [30fd65] rtlib: Fix 64bit/DOS build (was broken by previ...
 tests 2015-10-29 dkl dkl [2d722b] rtlib: Fix wstring-to-zstring conversion functions
 .gitignore 2015-07-02 dkl dkl [764a1a] gitignore binaries in doc/ (fbdoc, makefbhelp, ...
 .travis.yml 2013-04-30 Ebben Feagan Ebben Feagan [31e253] changing travis to hardcoded path
 changelog.txt 2015-10-29 dkl dkl [2d722b] rtlib: Fix wstring-to-zstring conversion functions
 makefile 2015-10-28 dkl dkl [d39fef] makefile: Exclude XCB binding from DOS package ...
 readme.txt 2015-01-01 dkl dkl [7fbbc2] Update to 2015
 todo.txt 2015-10-28 dkl dkl [e85930] parser: Disallow fixed-length strings as BYREF ... 2015-10-01 dkl dkl [a89298] Start FB 1.05.0

Read Me

    FreeBASIC - A multi-platform BASIC Compiler
    Copyright (C) 2004-2015 The FreeBASIC development team.

    Official site:
    Online manual:
    fbc project page:
    GitHub mirror:
    IRC channel:        ##freebasic at

    FreeBASIC consists of fbc (the command line compiler), the runtime libraries
    (libfb and libfbgfx), and FreeBASIC header files for third-party libraries.
    In order to produce executables, fbc uses the GNU binutils (assembler,
    linker). When compiling for architectures other than 32bit x86, fbc depends
    on gcc to generate assembly.

    Documentation of language features, compiler options and many other details
    is available in the FB manual. For help & support, visit the FB forum!

  o Installation & Usage

    FreeBASIC gives you the FreeBASIC compiler program (fbc or fbc.exe),
    plus the tools and libraries used by it. fbc is a command line program
    that takes FreeBASIC source code files (*.bas) and compiles them into

    fbc is typically invoked by Integrated Development Environments (IDEs) or
    text editors, from a terminal or command prompt, or through build-systems
    such as makefiles. fbc itself is not a graphical code editor or IDE!

    Win32 (similar for Win64):
      Download and run the latest FreeBASIC-x.xx.x-win32.exe installer, or
      download and extract the latest

      Now you can use fbc.exe from the installation directory to compile FB
      programs (*.bas files) into executables (*.exe files). Open a command
      prompt (cmd.exe) and run fbc.exe from there, for example:
        1. Click Start -> FreeBASIC -> Open console
        2. In the opened command prompt, type in the following command and
           press ENTER:
             > fbc.exe examples\hello.bas
        3. This should have created examples\hello.exe in the FreeBASIC
           installation directory. You can run it by entering:
             > examples\hello.exe

      Optionally, you can install a text editor or IDE which will invoke fbc.exe
      for you, for example:

    Linux (if FreeBASIC is not available through your package manager):
      Download and extract the latest FreeBASIC-x.xx.x-linux.tar.gz. Open a
      terminal and cd into the extracted FreeBASIC-x.xx.x-linux directory, and
      run "sudo ./ -i" to copy the FB setup into /usr/local.
      To compile FB programs, please install the following packages (names may
      vary depending on your Linux distribution):
          gcc libncurses5-dev libffi-dev libgl1-mesa-dev
          libx11-dev libxext-dev libxrender-dev libxrandr-dev libxpm-dev
          gcc ncurses-devel libffi-devel mesa-libGL-devel
          libX11-devel libXext-devel libXrender-devel libXrandr-devel
      If you want to use the 32bit version of FB on a 64bit system, it is
      necessary to have the gcc 32bit multilib support and 32bit versions
      of the libraries installed.
          gcc-multilib lib32ncurses5-dev libx11-dev:i386 libxext-dev:i386
          libxrender-dev:i386 libxrandr-dev:i386 libxpm-dev:i386

      Now you can use fbc to compile FB programs (*.bas files) into executables.
      For example:
        $ cd FreeBASIC-x.xx.x-linux/examples
        $ fbc hello.bas
      This should have created the hello program. You can run it by entering:
        $ ./hello

      Optionally, you can install a text editor or IDE which will invoke fbc for
      your, for example:
        Geany: (sudo apt-get install geany)

      Download and extract the latest

      Now you can use fbc.exe from the installation directory to compile FB
      programs (*.bas files) into executables (*.exe files). For example:
        > fbc.exe examples\hello.bas
      This should have created examples\hello.exe. You can run it by entering:
        > examples\hello.exe

  o Licensing

    The FreeBASIC compiler (fbc) is licensed under the GNU GPLv2 or later.

    The FreeBASIC runtime library (libfb and the thread-safe version, libfbmt)
    and the FreeBASIC graphics library (libfbgfx and the thread-safe version,
    libfbgfxmt) are licensed under the GNU LGPLv2 or later, with this exception
    to allow linking to it statically:
        As a special exception, the copyright holders of this library give
        you permission to link this library with independent modules to
        produce an executable, regardless of the license terms of these
        independent modules, and to copy and distribute the resulting
        executable under terms of your choice, provided that you also meet,
        for each linked independent module, the terms and conditions of the
        license of that module. An independent module is a module which is
        not derived from or based on this library. If you modify this library,
        you may extend this exception to your version of the library, but
        you are not obligated to do so. If you do not wish to do so, delete
        this exception statement from your version.

    The FreeBASIC documentation is licensed under the GNU FDL.

    Dependencies on third-party libraries:

    The FreeBASIC runtime library uses LibFFI to implement the Threadcall
    functionality. This means that, by default, FreeBASIC programs will be
    linked against LibFFI when using Threadcall. LibFFI is released under
    the MIT/Expat license, see doc/libffi-license.txt.

    By default, FreeBASIC programs are linked against various system and/or
    support libraries, depending on the platform. Those include the DJGPP
    libraries used by FreeBASIC for DOS and the MinGW/GCC libraries used by
    FreeBASIC for Windows.

  o Included/used third-party tools and libraries:

    - DJGPP
    - GCC 
    - GNU binutils
    - GNU debugger
    - GoRC
    - LibFFI
    - MinGW
    - MinGW-w64
    - OpenXDK
    - TDM-GCC

  o Credits

    Project members:
    - Andre Victor T. Vicentini (av1ctor[at]
        Founder, main compiler developer, author of many parts of the runtime,
        FB headers (FBSWIG)
    - Angelo Mottola (a.mottola[at]
        Author of the FB graphics library, built-in threads, thread-safe
        runtime, ports I/O, dynamic library loading, Linux port.
    - Bryan Stoeberl (b_stoeberl[at]
        SSE/SSE2 floating point math, AST vectorization.
    - Daniel C. Klauer (daniel.c.klauer[at]
        FB releases since 0.21, C & LLVM backends, 64bit port,
        dynamic arrays in UDTs, virtual methods, preprocessor-only mode,
        miscellaneous fixes and improvements.
    - Daniel R. Verkamp (i_am_drv[at]
        DOS, XBox, Darwin, *BSD ports, DLL and static library automation,
        VB-compatible runtime functions, compiler optimizations,
        miscellaneous fixes and improvements.
    - Ebben Feagan (sir_mud[at]
        FB headers, C emitter
    - Jeff Marshall (coder[at]
        FB releases since 0.17, FB documentation (wiki maintenance, fbdocs
        offline-docs generator), Gosub/Return, profiling support, dialect
        specifics, DOS serial driver, miscellaneous fixes and improvements.
    - Mark Junker (mjscod[at]
        Author of huge parts of the runtime (printing support, date/time
        functions, SCR/LPTx/COM/console/keyboard I/O), Cygwin port,
        first FB installer scripts.
    - Matthew Fearnley (matthew.w.fearnley[at]
        Print Using & Co, ImageInfo, and others, dialect specifics,
        optimization improvements in the compiler, many fixes and improvements.
    - Ruben Rodriguez (rubentbstk[at]
        Var keyword, const specifier, placement new, operator overloading and
        other OOP-related work, C BFD wrapper, many fixes and improvements.
    - Simon Nash
        AndAlso/OrElse operators, ellipsis for array initializers,
        miscellaneous fixes and improvements.

    - 1000101
        gfxlib2 patches, e.g. image buffer alignment
    - Abdullah Ali (voodooattack[at]
        Windows NT DDK headers & examples
    - AGS
        gdbm, zlib, Mini-XML, PCRE headers
    - Claudio Tinivella (tinycla[at]
        Gtk tutorials
    - Chris Davies (c.g.davies[at]
        OpenAL headers & examples
    - Dinosaur
        CGUI headers
    - D.J.Peters
        ARM port, ODE headers & examples, Win32 API header fixes
    - Dumbledore
        wx-c headers & examples
    - dr0p (dr0p[at]
        PostgreSQL headers & examples
    - Edmond Leung (leung.edmond[at]
        SDL headers & examples
    - Eric Lope (vic_viperph[at]
        OpenGL & GLU headers & examples, examples/gfx/rel-*.bas demos
    - Florent Heyworth (florent.heyworth[at]
        Win32 API sql/obdc headers
    - fsw (fsw.fb[at]
        Win32 API headers, Gtk/Glade/wx-c examples
    - Garvan O'Keeffe (sisophon2001[at]
        FB ports of many NeHe OpenGL lessons, PDFlib examples
    - Hans L. Nemeschkal (Hans.Leo.Nemeschkal[at]
        DISLIN headers
    - Jofers (spam[at]
        ThreadCall keyword, libffi/libjit headers, FreeType examples
    - Jose Manuel Postigo (postigo[at]
        Linux serial devices support
    - Laanan Fisher (laananfisher[at]
        FB test suite using CUnit
    - Matthew Riley (pestery)
        OpenGL, GLFW, glext, FreeGLUT, cryptlib headers
    - Matthias Faust (matthias_faust[at]
        SDL_ttf headers & examples
    - Marzec
        SDL headers, SDL_bassgl, SDL_opengl and SDL_key examples
        First file routines for FB's rtlib
    - MJK
        big_int header fixes
    - MOD
        wx-c, BASS headers; -lang qb support for built-in macros,
        "real" Rnd() algorithm
    - Nek (dave[at]
        Win32 API headers
    - Plasma
        FMOD and BASS headers & examples
    - Randy Keeling (randy[at]
        GSL matrix example
    - Saga Musix (Jojo)
        BASS examples with sounds
    - Sisophon2001
        gfxlib2 fixes, Nehe OpenGL lesson ports
    - Sterling Christensen (sterling[at]
        Ex-project-member, author of FB's initial QB-like graphics library
    - TeeEmCee
        gfxlib2 fixes
    - TJF (Thomas.Freiherr[at]
        ARM port, GTK+, glib, Cairo, Pango headers & examples,
        SQLiteExtensions headers
    - zydon
        Win32 API examples

    - Plasma
        Owner of the domain and main site hoster, many thanks to
    - VonGodric
        Author of the first FreeBASIC IDE: FBIDE.
    - Everybody that helped writing the documentation (and in special Nexinarus 
      who started it)
    - All users that reported bugs, requested features and as such helped 
      improving the compiler, language and run-time libraries.