• Home
  • Author: Joel G Mathew

Donate to Droidzone open source projects

Show your support for my open source projects by Donating!

I code for fun. I’m not a professional programmer, and my job is something very, very different from my hobby. Your donations will help me maintain my VPSes and dedicated servers (if any), and fund my collection of books.

Your donations help keep these projects and many more alive, and in the open source realm.


(Unofficial) FreeBASIC Manual

The latest complete Freebasic Wiki has been hosted on Droidzone.

All of the content provided in these packages is also available from the official FreeBASIC wiki located at www.freebasic.net/wiki

This download has been provided in the hopes that it may be useful.

The FreeBASIC Manual is licensed under GFDL – GNU Free Documentation License Version 1.2, November 2002. A copy of this license is available within the downloadable documentation itself.

DISCLAIMER : By downloading this documentation you are assuming all responsibilities for its use. The providers of this documentation make no warranties of any kind and assume no liability, whatsoever.


FreeBasic Compiler

Linux version – 0.23.0

FreeBASIC Manual v0.20.0b (2008.08.11)

Conversions of the official wiki documentation to other formats (Files hosted at FreeBASIC project page):

CHM format  – FB-manual-0.20.0-chm.zip
HTML format  – FB-manual-0.20.0-html.zip
TXT format  – FB-manual-0.20.0-txt.zip
FBHELP format  – FB-manual-0.20.0-fbhelp.zip
WAKKA format  –  FB-manual-0.20.0-wakka.zip

fbhelp – Version 0.8b (2008.08.11)

A console based viewer for FreeBASIC documentation (Files hosted at FreeBASIC project page). Viewer and help file are seperate downloads – see above for latest data file.

Windows v0.8b viewer:  – fbhelp-v0.8b-win.zip
DOS v0.8b viewer:  – fbhelp-v0.8b-dos.zip
Source Code v0.8b:  – fbhelp-v0.8b-src.zip

Screen capture of fbhelp running in dos window

Previous Versions:

Due to limited server space, please obtain old CHM versions of the manual from the FreeBASIC downloads section at http://sourceforge.net/projects/fbc.   Individual HTML files can be obtained by decompiling the CHM. Sorry for the inconvenience. See FreeBASIC Manual Downloads in the FreeBASIC wiki for a listing of files hosted by sourceforge.net.

FreeBASIC Manual v0.18.5b to v0.18.6b (2008.04.28)

CHM format  – fbdoc-v0.18.5b-chm.zip 1.02 MiB
HTML format  – fbdoc-v0.18.5b-html.tar.gz 588 KiB
TXT format  – fbdoc-v0.18.5b-txt.zip 401 KiB
FBHELP format  –  fbdoc-v0.18.5b-fbhelp.zip 428 KiB

FreeBASIC Manual v0.18.4b (2008.04.15)

TXT format  – fbdoc-v0.18.4b-txt.zip 399 KiB
FBHELP format  –  fbdoc-v0.18.4b-fbhelp.zip 428 KiB

FreeBASIC Manual v0.18.3b (2007.12.12)

TXT format  – fbdoc-2007.12.12-txt.zip 376 KiB
FBHELP format  –  fbhelp-2007.12.12-data.zip 403 KiB

FreeBASIC Manual v0.18.2b (2007.11.04)

TXT format  – fbdoc-2007.11.04-txt.zip 370 KiB
FBHELP format  –  fbhelp-2007.11.04-data.zip 398 KiB

FreeBASIC Manual (2007.10.08)

TXT format  – fbdoc-2007.10.08-txt.zip 366 KiB
FBHELP format  –  fbhelp-2007.10.08-data.zip 395 KiB

FreeBASIC Manual v0.18.1b (2007.09.04)

TXT format  – fbdoc-2007.09.04-txt.zip 358 KiB
FBHELP format  –  fbhelp-2007.09.04-data.zip 386 KiB

FreeBASIC Manual v0.17b (2007.08.08)

TXT format  – fbdoc-2007.08.08-txt.zip 354 KiB
FBHELP format  –  fbhelp-2007.08.08-data.zip 375 KiB

fbhelp – Version 0.7b (2007.08.09)

Windows v0.7b viewer:  –  fbhelp-v0.7b-win.zip 71 KiB
Dos v0.7b viewer:  –  fbhelp-v0.7b-dos.zip 119 KiB
Linux v0.7b viewer:  –  fbhelp-v0.7b-linux.tar.gz 80 KiB
Source Code v0.7b:  –  fbhelp-v0.7b-src.zip 54 KiB

fbhelp – Version 0.6b (2007.02.22)

Source Code v0.6b:  –  fbhelp-v0.6b-src.zip 53 KiB

Want to help improve the FreeBASIC documentation? Visit the FB Wiki – Help page to found out how.

How to install Supernova


  • If your Hboot is not stock (like Oxygen/CM), you should change it back to Stock Hboot before flashing. This is a stock Rom.

  • Remember the Golden Rule of Happy Flashing: Always create a Nandroid backup before proceeding

  • If you’re going to try partitioning your card, always copy the entire sdcard contents to a backup folder on your hard disk.

  • Note that Nandroid backups are saved to /sdcard/clockworkmod/backup and Titanium backups are saved to /sdcard/TitaniumBackup folder. These should periodically be backed up to hard disk especially before a Partitioning operation.

  • Partition only with Gparted

  • Partitions-Two partitions are required. First one should be Fat32 primary, and the second should be ext4 (Our script does try to convert other partitions like ext2, ext3 to ext4. However, if this fails, create an ext4)

  • The order of making partitions in Gparted is important. Sequentially, the first should be Fat32 (not Fat), and the second should be ext4

  • Wipe recommended on first install [Only scenario where it is not required is when you were already on Sibere’s ext4 Data2Sd on another Sense Rom]. (If you’re reinstalling my rom again, you dont need a wipe)

  • A Class 4 or above SD card is recommended for Data2sd. If you use Class 2, you may notice a perceptible lag.

  • Recommended Recoveries: Use either CWM (Highly recommended), Alpharev CWM, Amon Ra, or CWM posted by Kali. Links on Resources page). Kindly note that other editions of CWM have serious bugs!)

  • Turn signature verification off in Recovery menu before running the installer script (Otherwise you will receive messages like File/Signature verification failed)

  • If you’re installing a new version of Data2SD code, then unless otherwise specified, you’re supposed to install after a clean wipe.

  • Very important: DO NOT ATTEMPT TO USE THE INSTALLER OF ONE VERSION OF DATA2SD AND REINSTALLER FROM ANOTHER VERSION OF DATA2SD. IF YOU WANT TO SWITCH DATA2SD VERSIONS (OR UPGRADE TO DATA2SD), OR SWITCH BETWEEN STABLE AND BETA VERSIONS, USE “Re-Installing over an existing installation because of code revision in the Data2SD code” procedure! Alternately use the migration scripts. Note that the migration scripts are betas and may have bugs. So take a Nandroid backup before running any of them.

  • If you’re using ROM Manager to install SuperNova, only use it to download the ROM and other files. Never run the flashable zips directly from ROM Manager! This rule does not apply to the Classic Edition.

  • In case you run into any issues during installation, or cannot get SuperNova to work, before you ask for help, goto this page, and copy the “Form for asking questions”, paste it into the SuperNova thread after filling your responses. If you dont do this, your post will just be ignored!


There are three different installation scenarios.

  1. Installation for the first time- When you’re coming from another ROM and doing everything for the first time, including partitioning
  2. Re-Installing over an existing installation because of code revision in the Data2SD code
  3. Updating the ROM over an existing ROM when there is no significant change in Data2sd code

Installation for the first time: (For a more detailed instruction set, see Step-by-step method for the Newbie, below)

1. Full Wipe is necessary when installing for the first time (Backup your data in both recovery and Titanium before installing)

2. Partition your sd card into two partitions-The First must be Fat32 Primary, and the second can be any Primary ext partition-ext2/3/4 (ext4 preferred)

2.1 For SuperNova, it is recommended that you flash the latest compatible Radio.

3. Install the Rom zip from recovery



4. Boot once, allow system to stabilize. Do NOT install any applications/restore any applications at this point. Also do not enter your Google account details at this point. You can do all that later. Note that you must enter Wifi settings, Network settings and Language settings at this point (before Data2sd is installed), if you want system settings to be saved. Otherwise these will be forgotten on each reboot (if you’re using Stable version of Data2SD. Beta code of Data2sd has this corrected)

5. At this point you will be having a simple Non A2SD, Non Data2SD setup

6. Reboot into recovery once more, run the Data2sdInstaller.zip


Re-Installing over an existing installation because of code revision in the Data2SD code

Note that you can always install any new version of SuperNova Standard or Lite any time it is released. Unless you manually want to change your Data2SD code, you can always install a new Standard or Lite Rom over your previous Rom of the same flavor, if you follow it up with the Data2SD Reinstaller of the previous Data2SD code you had. The following steps are applicable only when you want to change to a newer Data2SD code.

  1. Complete backup of user apps+system data from Titanium
  2. Wipe data/Factory reset from Recovery
  3. Install ROM
  4. Boot once, choose language and region
  5. Reboot to recovery, install the latest Data2sd installer
  6. Reboot
  7. Titanium restore: Restore missing apps+All system data

Updating the ROM over an existing ROM when there is no significant change in Data2sd code

Standard and Lite editions

(When you are updating the Main ROM OR After reflashing the rom for any purpose like removing system apps and widgets )

This should be done only if you have run the Data2SD installer zip at least once previously and havent wiped your sd-ext after that

  1. Flash the main rom after removing any apps/widgets you dont want (Removing system apps is always tricky with any Sense rom and may cause boot loops/force closes of its own)
  2. Immediately after flashing the rom, install the DATA2SD Reinstaller zip. (Note that this this is to be done immediately after flashing the main rom and not after a reboot)

Note: If you ever wipe before a ROM install, you have to use the Data2SD installer and not the Reinstaller!


Note that the order and time at which you flash the Rom, Data2SD installer and Reinstaller is important.

Step-by-Step method of Installation for the Newbie for a First Time Installation)

  1. First Step: Reboot into Recovery Right now and Backup your Nandroid. Optionally and if you have these softwares, do in addition a backup from Titanium Backup and MyBackupPro
  2. Second Step: Copy the entire contents of your MicroSD card, including specifically the folders Clockworkmod, TitaniumBackup and Rerware to a safe location on your PC; depending on whether you do/dont have Titanium backup and MyBackupPro installed.
  3. You cannot install this ROM on top of your existing ROM. A complete delete of partitions followed by repartitioning is required. If you already have a Fat32 followed by an ext partition, you can try installing as per above instructions after a full wipe. But if there are some issues, do the repartitioning to fix it.
  4. Preparing the Recovery before Partitioning: Do a Complete Nandroid Wipe (That is, choose the wipe data/factory reset option)
  5. Partitioning: Boot up the Gparted LiveCD
  6. Choose your MicroSD card reader device, select each partition and delete each.
  7. Then hit “Apply changes”
  8. At the beginning of the free space, create the fat32 partition first as fat32 primary, Leave space unallocated at the end to create the ext4-Choose how much space you want as ext4, and leave this space at the end unallocated. The total amount of space in your card minus the amount you choose for your data in ext4, is what you type in as size for the fat32.
  9. Now create ext4 parition after the FAT32 Partition.Note that the First partition must be Fat32 (never FAT), and the second must be ext4. The order must not be changed. There should also not be any unused space at the beginning of either partitions, or between the two.
  10. Apply changes, and boot to your Desktop.
  11. Copy both zips (rom, data2sdinstaller or data2sdreinstaller as the case may be) to the fat32, insert the card into your phone.
  12. Install rom.

The next few steps differ depending on which edition of SuperNova you are installing.


  1. If you are installing SuperNova for the first time, after installing the Rom you have to boot to Android first, choose language and other options. Then right after that without downloading any applications or using the Market, you have to enter Recovery once again and install the Data2SD Installer
  2. If were already SuperNova previously and just want to update, just boot to Recovery, and Backup your Nandroid. Then install the Rom zip first. Without rebooting, apply the Data2SDReinstaller. Now boot to Android to use updated SuperNova


  1. If you are installing SuperNova for the first time, after installing the Rom you have to boot to Android first, choose language and other options. Then right after that without downloading any applications or using the Market, you have to press and hold the Power button and choose Reboot.
  2. On the next startup, a green LED will flash for around a minute and indicates creation of the new Data2SD ext4 partition and initialization procedure. Then, a blue LED will flash signifying successfully starting the Data2SD program. Check your SD settings, and you will now see the increased amount of internal storage space.
  3. If were already SuperNova previously and just want to update, just boot to Recovery, and Backup your Nandroid. Then install the Rom zip. Then just restart from recovery to Android system, and all should be done.

In case you followed all the steps correctly and still ended up with a freeze at the HTC/Alpharev Joker logo, see the “How to ask for help” post in the Resources section.

Data2d Beta Code

When I refer to “beta” henceforth, I wont be using the old terminology of calling W versions as Beta. Both W and X version code have beta versions.  They are in beta because the theoretical possibility of them causing bootloops after kernel flashes cannot be ruled out.

The beta code will be referred to with the suffix E. So, the beta of W version is WE, that of X is XE.

To convert X version to XE, flash the XE Reinstaller. If you need to use this code righ after a fresh rom install, use the corresponding Installers. (For more instructions read the Install page)

The flashable zips can be downloaded here.

Classic Edition

Main Rom ( – Classic Edition (Intelligent Data2SD)

ROM Category: Development Release/Test Build

When you report issues with a dev release, dont expect it to be fixed soon.

  • Lightly Customized ROM
  • Built-in Data2SD (No need to use the Data2Sd installer/Reinstaller)
  • UOT Theme
  • Essential Thirdparty app

The difference between this Rom and the other Roms (Classic and Lite editions) is that Data2SD in this Rom is Built in. You do not have to install the Data2SD installer/Reinstaller over the Rom to get Data2SD.

To install, wipe completely, and install the Rom. On first boot, setup your Language and Wifi settings (if you want). You can also set these up later and can also just skip everything till you land on the home screen. Once system has settled down, hit the power button and choose “Reboot”. When you reboot, a green LED will come on, and Data2SD will be installed according to the size of the ext partition. Then, a blue LED will flash signalling successful loading of Data2SD.

This version has the Adbirdie Keyboard as default, a custom battery mod from UOT, and flying Windows animation. Note that the framework of this Rom is different from other StarBurst Roms. The Kernel is Neo 1000mv which is good for extended batteries.

NOTE: Wiping the CACHE partition will completely remove your Data2sd Data partition, and will cause your previously functioning apps to stop functioning. If you need to wipe cache, use this script to backup your Cache, and restore it after you wipe the Cache safely.

How to Install the Classic Edition?

First time users can install Classic right after partitioning their card, and wiping. To migrate to StarBurst Classic X2 from any other version, first convert your current script to X1 with the Migration code, and then use this X1 to X2 migration code. Following that, you can install Classic Rom without a Wipe.

MD5: b872367bd2e6b0e3706d28860676ed77

Data2SD Migration Code

Data2SD Migration Code:

There are now three different versions of Data2SD:

  1. W series (previously called Beta code): Moves dalvik-cache and all system settings to nand. Superfast. Known Issues: Nand may fill up fast and impose an absolute limit on number of apps that may be installed. Should be enough for most people. If you face the issue, you can switch to X series.

  2. Setting fix version (X series): Difference from W sereis is that settings is left on Nand, while dalvik-cache of apps is moved to sdcard. So you dont get the limit of apps like W series. May be slightly worse in performance compared to W series

  3. Stable version (tiny series): /data completely shifted to Sdcard. Known issue: Settings (Wifi, language-if not set at first boot; etc ) revert to default on each reboot.

Note: Use the Migration zip for Stable (tiny) series cautiously. It’s been sparsely tested.

I’d like feedback on the use of these scripts to improve upon them. Let me know whether it worked for you.

Migrate W series to X series

Migrate W series to tiny series

Migrate X series to W series

Migrate tiny series to X series

Migrate X1 to X2 (For upgrade to StarBurst Classic)

How to upgrade to a new version?

Important Points

  1. Before installing any newer version of the ROM, make sure to do a full Titani

New ROM version

If you were using Standard version, and upgrading to newer Standard vesion, or similiarly from Lite to newer Lite:

  1. Boot to recovery
  2. Backup from Recovery
  3. Install the new Rom from recovery without a wipe.
  4. Immediately install the Data2SD reinstaller (This should be the Reinstaller corresponding to the Installer you previously used. Note: You should never use a newer Data2SD reinstaller while doing a reinstall, unless specifically told to)
  5. Reboot

New Data2SD version

If you wish to switch between W, X and Tiny versions, use the migration code. Nandroid backup before doing that.

A method which always works is described below.

  1. Make a Titanium backup (Backup “User apps+All system data”)
  2. Boot to recovery
  3. Backup from Recovery
  4. Wipe data/Factory reset from Recovery
  5. Install ROM
  6. Reboot to Android desktop, choose Language, wipe and other network settings. Never enter the Google account details at this point! Never use the Android Market either
  7. Install the newer Data2SD installer
  8. Reboot to Android desktop, open Titanium backup and choose “Restore missing apps + all system data”

Changing ROMs (Standard to Lite, and vice versa)

Usually, you can install like the first method above. If there are issues doing that, use the second method