
    GCBASIC - A BASIC Compiler for microcontrollers
    Copyright (C) 2006-2010 Hugh Considine
    Version (0.9 10/11/2010)
    Package date November 24 2010

Compiled November 9 2010 by WTN using FreeBASIC 0.20.0 (08-10-2008) under
Ubuntu 8.04.4 (fbc recompiled Oct 22 2009, using custom libfb.a May 14 2009).
Windows gcbasic.exe compiled under wine using the stock fbc.exe binary.
Command line used for compiling: fbc gcbasic.bas

Note - the binaries might not be compatible with all OS versions, if problems
are encountered try recompiling using FreeBasic (http://www.freebasic.net/),
and maybe let me know with the OS version and a working binary if available.
This can sometimes be an issue for Linux systems, for reference ldd displays
the following library dependencies for the gcbasic binary...

	linux-gate.so.1
	libc.so.6
	libm.so.6
	libpthread.so.0
	libdl.so.2
	libncurses.so.5

Changes from previous (0.9 10/9/2010) version...

assembly.bi - fixed assembly above address 0x8000 (wtn)
gcbasic.bas - fixed relative calculations crossing string tables (Hugh)

Changes from November 13 2010 package...

stdbasic.h - modified Poke to fix an issue with Peek (wtn)

Directories and Files...

chipdata/     required for operation, contains data for supported chips
gcbsource/    FreeBASIC source code for gcbasic[.exe]
include/      some contents required for operation, contains include files
gcbasic       binary compiled for Linux x86 systems
gcbasic.exe   binary compiled for Windows systems
gcbasic.chm   Windows-format help file
gcbasic.ini.orig  optional settings file, rename to gcbasic.ini to enable
license.txt   GNU Public License v2, terms for using the compiler
LGPL.txt      Lesser GNU Public License v2.1, terms for the includes
messages.dat  required for operation, contains text messages

Some include contents are copyright by others, see the individual files.
The Great Cow Basic home page is at: http://gcbasic.sourceforge.net/
For issues related to this version contact Terry Newton (wtn90125@yahoo.com),
for general compiler help or issues not related to the changes here refer
to the GCB home page and forum. If the contents of this directory tree are
modified and redistributed please remove or edit this readme file accordingly.

Installation and use...

See the gcbasic.chm file for usage under Windows, rename gcbasic.ini.org to
gcbasic.ini and edit if not using command line parameters (i.e. drag-n-drop).

For Linux command line use, copy to a convenient directory and specify the
dir name in the command line. For best results use with gputils 0.13.7 or
above (http://gputils.sourceforge.net), compile and install. If using a
binary package make sure it's 0.13.7 or above, earlier versions won't work.

Command line example: ~/gcb/gcb -a:"gpasm -i prog.asm" prog.gcb
The gpasm -i option is required, ignore the warning about case.

The environment variables documented in gcbasic.chm do not work under Linux
(nor can they - typically a binary cannot change env vars without procedures).
Making a script to automatically compile with a single parameter (command line
or from a GUI) is tricky but the following scripts work for me...

----- file gcb_extasm -------------------------------------
#!/bin/bash
#edit below to specify location/name of gcbasic binary
gcbasic=/path/to/gcbasic
assembler="/path/to/gcassembler $1"
if [ -e $1 ]; then
 xterm -e $gcbasic -a:"$assembler" $1
fi
----- end gcb_extasm --------------------------------------

----- file gcassembler ------------------------------------
#!/bin/bash
asmfile=`echo $1|head -c -5`.asm
echo asmfile=$asmfile
gpasm -i $asmfile
echo === press enter ===
read nothing
----- end gcassembler -------------------------------------

The scripts must be in unix format and given execute permissions.
Edit the gcb_extasm script to specify the location of the gcbasic binary
and the gcassembler script, as written requires "xterm" to display output
and permit running from a GUI via association. The source, scripts and
compiler files must not be in a directory that contains spaces.
These scripts are provided as-is and without warranty.
