=======================================
GBL Design Studio 2009 Personal License
GBL Design Studio 2009 Evaluation License
GBL Design Studio 2009 Professional Single User Commercial License

2006-2008 (c) GB Research, LLC
=======================================

=======================================
What's Included
=======================================

Installation package includes the following files and directories:

Readme.txt - this file
License.pdf - license file
GBL Designer - graphical design entry
Tracer - tracer application
lib - directory contains compiled GBL library
include - directory contains GBL header files
source - directory contains GBL source files (Professional version only)
packages - directories contain GBL packages
examples - directory contains GBL examples
help - directory contains GBL help files
*.mak - make files for supported tool sets

=======================================
Installing Windows XP/Vista version
=======================================

Start the installer by launching setup.exe file and follow the instructions.
If you downloaded the package, the Serial Number for your product was sent 
to you by e-mail.
If you received the product on CD, the Serial Number is printed on the CD sleeve.

To uninstall the product, choose Uninstal from GBL Design Studio program group.
Alternatevely, click on the Start button, Control Panel, choose Add or 
Remove Programs, select the corresponding version of the software and click
Remove.

The software was tested under Windows XP Professional. 
It may work on the other versions of Windows, but it is not guaranteed.

=======================================
Configuring toolsets
=======================================

Current release of GBL Design Studio includes support for Microsoft
Visual C++ (VC8 and VC9) and C++ Builder 2006 & 2009 (BCB6 and BCB9) compilers.
By default, the software is configured for VC8. Due to large size of
compiled libraries only VC8 compiled packages are included. If you configured
a different toolset, rebuild package GBL project:
[INSTALLDIR]\source\packages\BasicModules\BasicModules.gbl

To configure GBL Designer for one of the supported toolsets:

-- open Designer Properties by selecting Designer node,
-- change Package Directory to packages\vc* or packages\bcb*
-- change Make Utility to Borland "make" or Microsoft "nmake"
-- change GBL Lib Directory to [INSTALLDIR]\lib\BCB* or [INSTALLDIR]\lib\VC*
-- if necessary, open package project, recompile and export packages

The other configuration parameters do not depend on the used toolset.

If changing the existing GBL projects to a different toolset, select
Project node and in Project Properties change Imported Packages to 
include only packages for the chosen toolset. Reloading a package links correct
libraries for that package.

Libraries for different toolsets have incompatible formats. If you mix them, the
linker will report errors.

The Windows SDK download from Microsoft can also be used as a toolset 
for building GBL modules. Change PLATFORM_SDK_PATH, PLATFORM_SDK_INCLUDE,
PLATFORM_SDK_LIBPATH macros in designer_vc8.mak file to reflect the
SDK installation.

=======================================
Known issues
=======================================

C++ Builder 2006-2009 doesn't correctly support argument-dependent lookup (ADL.)
Therefore, some expressions, like 2 * GBL::Tick will fail to compile. To solve
this problem, either modify the expression to GBL::Tick * 2, or open GBL
namespace by writing "using namespace GBL;"

There were noticed some bugs in BCB, when no code was generated to invoke
destructors of local variables leaving scope. That would cause failures in parts
of the library that rely on RAII. Experimentaly, it was determined that closing
BCB and deleting all generated *.obj, *.lib files then restarting BCB and
recompiling the projects fixed the problem.

=======================================
Limitations
=======================================

The Personal Version is limited to personal and educational non-commercial uses
only. Personal Version is limited to small projects of maximum 5 modules, each
containing not more than 10 elements. Personal Version of GBL Designer builds
only debug targets. Due to these limitations Personal Version cannot be used
to rebuild supplied packages for a different toolset.
The Evaluation Version has the full functionality of the Professional Version and
is limited to 30-day evaluation period. See License Agreement for terms of use.

=======================================
Feedback
=======================================

Would you like to provide us with feedback, bug report, feature request, etc; 
please use the form on "Contact Us" web page at 
http://www.gbresearch.com/contact_us.aspx

=======================================
Other Notes
=======================================

Licensed users of Professional Version can receive support and updates 
on the wiki site: http://www.gbresearch.com/wiki/login.aspx

If you want to install multiple (different) versions of software, you may do so
by choosing different installation directories.
When installing a new build of the same major and minor version of software,
uninstall the old version before installing the new one.

Please save the media or downloaded files and serial numbers in case you need to
reinstall the product in the future.

If you encountered problems during installation or run, please report them on
http://www.gbresearch.com/contact_us.aspx

The latest version of the software can be obtained at
http://www.gbresearch.com/gbl/Default.aspx