GS9 version v3.0b 110330
by Alexandru Simion

Version history:

v3.0b - 110330 switch and fixes
	. updated documentation
	. fixed bug in CompileFunctions, GS_NODE_DECFNC was not returning the error if failed
	. fixed bug in CompileFunction, the body statements error was not returned (was using a local ret variable)
	. optimization for 	PUSHNUM / ART -> ARTN (frans)
	. added support for switch/case working like in C/C++ (in grammar and compiler)
	. adjusted asm code log format (frans)
    
v3.0b - 110326 frans fixes
	. fixed bug string + number operation (gsOp_ADD_sn)
	. fixed bug in compiler optimization skipped (GS_CMD_ARTL+SET)
	. fixed buf in calling table string indexed element (like t.x())
	. defined macros for making op codes construction more elegant
	. optimization for call global (speed)
	. updated commands instruction log format (.s)
	. updated get tick count on mac
	
v3.0b - 110320 platformed
	. fixed bug with decrementation compilation (i-- was compiled as i++)
	. adjusted code for easier platforms integration (gs_stdafx, gs_platform, etc.)
	. added gs_system_win and gs_system_mac files; using with gs_system_en in engine
	. sys_findfiles no longer force lowercaps

v3.0b - 101222 updated
	. updated documentation
	. better compile flow (find global declarations first)
	. include files supported in functions too
	. namespce and include supported in functions too (global function needs them)
	. namespace support for locals (to be similar to globals)
	. var, def in global space only, but easy to add in functions too
	. def for global constants (num,str,ptr) initialized in compile and used as const values intead of global vars
	. keep local names in functions for debuggers
	. global function to initialize globals after compile (optional)
	. gs_compilefile, gs_compilestring, gs_compilebuffer compile the global function if gfname is provided
	. gs_docommand compiles code from string as content of a temporary function and runs it (removed gs_dofile, gs_dobuffer)
	. some constants were removed from grammar and compiler and registered as global consts (NULL, TYPE_, PI, etc.)
	. removed GetConst trick from compiler.
	. removed some NULOBJ, NULFNC checks. Recomended to use ZERO (0) instead.
 	. fixed bug parser buffer with ending double 0
	. fixed bufg in vm LOADF leak
	. support to overwrite new, del funcions (regfnc)
	. gs_toval, gs_verify, gs_valstr
	. op true & false in comparing different types
	
v3.0b - 100501 updated
 	. fixed bugs in gslib_files, gslib_tables
 	. fixed SHL bug in operators
 	. fixed bug in gslib_strings
 	. fixed bug in env with deleting functions
 	. extended support for calling member functions (now accepts a.b.fn())
 	. changed params order for tabset ( tab, val, pos, count )

v3.0b - 100410 "3D"
	. single numeric type (float); integer no longer supported; readonly flag for globals was introduced in compiler to compensate for NIL predeclarations
	. removed NIL type; numeric zero is used instead
	. ptr type accepts operations with num type (+/-); position parameter associated with pointers was removed from libs (memory, files)
	. plus operator on tables add elements to support vectors math
	. two operators tables (unary and binary)
	. renamed to gs_ (no more gse, gso, gsc, etc) and to gs_type_
	. fixed grammar for a<b?1:0 to work like (a<b)?1:0 specific to c/c++
	. removed ?var operator that was returning the type of variable and was used for obsolete nil tests
	. tabpush, tabpop, tabresize (in place)
	. added NOLOOP compile error for break and continue operations outside loops
	. include command generates new nodes into the current compiling tree (grammar changed too)
	. two compile passes: globals first, functions second (so globals will be visible everywhere) 
	. allow more paramters than function needs (pop and loose them) - useful for callback techniques
	. callstack info when crashing in objects' methodes (callidx)
	. updated docs (tables, memory)
	. updated and renamed compile scripts for docs and grammar (they now work with current version of gs)
	
v3.0b - 091117 updated
	.upd MAC port
	.create xcode project

v3.0b - 091113 updated
	.upd back to no int-flt combinations in operators and math functions
	     this is better, to avoid bugs generated by storing integets instead of ints
	     and expect float from operations (like div). the problem was reduced but
	     not eliminated. will have to go for single numeric type

v3.0b - 091111 updated
	.upd all types are accepted as bool in conditional operations (jz,jnz)
	.upd soft type - set op maks no type checks, it just changes it
	.upd combined types in operators for int and float; uses ops tables
	.upd math and other flt using functions accept int
	.upd new gs_cknum, gs_ckint, etc.
	.upd added NULOBJ, NULFNC, GSOP_PUSHZERO
	.upd MAC port
	.upd updated docs
	.bug fixed gs_regvar (to return -1 not null)
	
v3.0b - 090813 updated
	.upd get,set methodes uses a zero based stack
	.upd ptr type was moved after tab
	.upd all types work as bool, except NIL
	.upd changed grammar: cast format, type values, NUL for obj and fnc, etc.
	.upd removed explicit global declarations (only var now)
	.upd no default lib (must be registered manually) 
	.bug fixed findfile, gs_env:158 global ref, 
	.bug fixed pp report on vm errors (pp--)
	.bug fixed doc index to gather all libs
	
v3.0b - 090718 Rewritten
	.upd most of the GS9 was rewritten for better speed and new features
	.upd strings and tables are managed and have reference counting
	.upd strings are immutable and unique, and are stored in a strings table
	.ups strings no longer expose the eos; sizeof(s) is the number of characters in string
	.upd values are no longer duplicated when pushed on stack
	.upd strings and tables are not duplicated when sent as parameters to functions
	.upd reference type was removed for speed purposes
	.upd multiple returning values support
	.upd new data types: function and object
	.upd function are stored as globals in the same globals variables table
	.upd support for c++ objects members access, through gsObj class and obj type
	.upd support for namespaces at compile time using long variables names
	.upd cache for strings and tables pointers to avoid memory fragmentation
	.upd different direct access and function calling from c/c++
	.upd changed the c/c++ function format; no longer needs to return 0 or 1
	.upd execution is stopped at the first encountered error (doesn't try to recover anymore)
	.upd support for precompiled binary scripts (export, import)
	.upd improved the assember instructions; use of set/get, setidx/getidx, etc.
	.upd updated and reorganized the libraries
	.upd updated the grammar using bison v2.4 (better errors reporting)
	.upd the GS9 book was updated

    experimental support:
        - "new" instruction to duplicate a table (not recursively) 
          to be used like pos = new Vec3 or mat = new Mat4x4 where Vec3 is [0.0f,0.0f,0.0f]
        - gsObj support to access C++ class ins,tances, by calling Get, Set, Call virtual functions.
        	
	note: DizzyAGE remains with GS9 v2.2

v2.2 - 080401 Upgrade (used in DizzyAGE v2.2)
	.upd added support for redefines (#def); if types match; used in multilanguage
	.bug fixed in console; poped the return, to avoid assert
	
v2.1 - 080201 Fixes (used in DizzyAGE v2.1)
	.bug fixed bad bug in gso_tabdel function
	.upd added elegant stack overflow test
	.upd added gs_isrunning function

v2.0 - 070612 New manual and updates (used in DizzyAGE v2.0)
	.upd type and size of object data changed to int instead of word, to allow huge strings
	.upd reversed zero defines for str and ptr. Now VOID is for strings and NULL for ptr.
	.upd logical operators and conditional jumps pop any type but NUL (false = 0, 0.0, VOID, bad ref, NULL)
	.upd simplified the gsdemo console to only use one command line parameter, for script file.
	.upd added scanln, getch in default lib and gs_commandline in win lib.
	.upd added tab add operator (+) to concatenate two tables.
	.upd restructured kit folders
	
	- 070901
	.bug gs_findfile fixed
	.upd doc reviewed

v1.3 - 070222 Doc, fixes and updates (intermediary build)
	.bug in gs.cpp was writing in the 32th of an array[32] 
	.bug reading characters from strings failed because of char is signed
	.bug some char - byte conversions in gsVM
	.upd ptr new type and VOID value in objects, lexer, parser, compiler and virtual machine
	.upd changed file lib to use ptr instad of int for file pointer
	.upd file write and read text functions use now both \r and \n for end of lines
	.upd vc2005 solution (VC8)
	.upd type casts, some gsstrlen and intptr type, to avoid warnings in VC8
	.upd OROR operation set to pop anything not just integers (hm?)
	.upd report file errors when not compiling (in include commands too)

v1.2 - 060306 Doc and fixes (used in DizzyAGE)
	.bug trim function was failing some cases
	.upd manual have been updated, including chm doc
	.upd added math library
	.upd strskip function in default lib
	.bug negative defines are now accepted
	.upd renamed gs_error and gs_debug

	- 070219 small fixes and port to VC8
	
v1.1 - 051224 Update and fixes
	.bug (gsasm.cpp,56) pos<=a.size at gso_tabins
	.upd (gsasm.h,19) gsObj( dword )
	.upd (gscfg.cpp) gsfile_open callback uses open modes: 0=rb,1=wb
	.bug (gscompiler.cpp,559) always add a return operation at the end of functions
	.bug (gsenv.cpp,52) check before free
	.bug (gsvm.cpp) treat operators as dwords in binary  operations, because of the sign bit in integers
	.upd changed library mechanism
	.upd added more library functions like gs_do, gs_compile, or file support
	.bug fixed string functions when called with reference to string
	.upd don't return NUL when fails in functions that should return something. avoid using NUL objects, always return an acceptable value
	.bug solved a = b?c:1 parseing
	.bug gsdemo.exe use the debug flags argument
	.bug solved string parseing issue "\\"
	.upd notify errors in linking goto, when having a continue or a break command outside a loop
	.bug gs_compile string bug fixed
	.bug gs_frand repartitioned was wrong
	.upd gs_cpycall( vm,buffer,size ) in gs.h.cpp, added call info in error handler msgbox (on halt)
	.upd gsassertvm( vm,exp ) in gscfg.h, GSE_ASSERT in gserror.h.cpp
	.upd gs_debug export to dynamical set the vm->m_debug flags (flags const not exported)
	.upd gs9.chm help with index and stuff :)

v1.0 - 050419 First official version (used in Saboteur95)
	.gs_dostring bug fixed
	.gs_recover will clear script callstack up to code level
	.gs_ckparams fixed
	.gso_tabs removed
	.file functions are over-writable
	.gserrorexit is over-writable; better errorexit
	.gsVM::Done clear callstack (recover)
	.libs are in the same directory

v0.6 - 050129
	.grammar: allow empty expressions, used in calls
	.fixed vm bug: objects leaks when comparing strings
	.libs: gs_rand, gs_frand, gs_srand
	.fixed nametype bug (non-static was returned)
	.implicit creation for STR and TAB; GSOP_NEW, GSNODE_NEW added
	.gserrorexit function
	.fixed decfn bug ( if params declaration failed, the error was not returned )
	.defines with values for INT,FLT,STR; grammar: defobj
	.obj values; NUL allowed; changed tokens to TOK_NULVAL, TOK_INTVAL, ...
	.table cookie indexing (tab.member) throught variable value; string indexing eliminated; GSOP_IDX; varidd
	.better error handeling: gsErrInfo, gsErrorHandler, error codes changed, etc.
	.debug local vars in vm for current line, file, func (only on _DEBUG)
	.less parameters in function call allowed (NULs are pushed)

v0.5 - 050112
	.gs_reglib and lib register function changed to use vm insteed of env
	.GSFN_SCRIPTED flag
	.bug in compiler (node - n)
	.restrict locals again (must have different names than globals or fn)
	.restrict defines
	.remove @ and IDI
	.DECEXP become IFEXP
	.remove VARCK node (simplified)
	.hash for fn, var, sym
	
v0.4 - 050111
	.explicit declarations for globals and functions ( int i; var i; func fn; func fn(){} )
	.implicit declarations for locals
	.allow local names to be the same as globals or functions
	.no more $ for globals (var:  find local; else find global; else add local)
	.sizeof, typeof operators
	.@idd insteed of #idd
	.?var to test if not NUL (return 0 if NUL else 1)
	.exp ? exp : exp (GSNODE_SELEXP)
	.deny redeclarations (no change of global types, or change of non-empty or exported functions)
	.compare (==,!=) strings

v0.3 - 050110
	.no more explicit declarations (except extern globals for clarity)
	.cast operators work on expressions
	.call function use fid as last param
	.bug gs_type fixed
	.grammar change for simplicity (decidd_list)

v0.2 - 050107
	fixed some bugs
	$ globals
	etc

v0.1 - 050103
	first release

If you want to ask questions or write your opinion, visit GS9 web site:
http://www.simion.co.uk/gs9