Scriptol to C++ or to native compiler
(c) 2001-2006 by Denis G. Sureau
http://www.scriptol.com             Home page.
http://scriptol.sourceforge.net   Open source project related to Scriptol.

Overwiew

This archive contains mainly solc, the Scriptol to native compiler.
A scriptol program may be interpreted by the Php interpreter and it may
be also compiled either to C++ or directly as an executable.
To build executables with solc under Windows, you can use:
- Borland's BCC 5.5 or further (www.borland.com/cbuilder/cppcomp/)
- Microsoft's Visual C (comes with the .net SDK or Visual Studio).
or MingW version 3.2 or further (www.mingw.org)
- Under Unix and Linux, GCC (http://gcc.gnu.org).
At least one of each required compiler is included on the Scriptol CD.


Installing the Scriptol compiler

Remove first the previous version or rename the directory: scriptolc.bak,
for example.
It is better to install Scriptol at root of a disk, for example:
 c:\scriptolc
Once the archive is extracted into the scriptolc directory, you have just to
change to this directory to run the compiler.
To use the compiler at command line from any directory, you have to put
the compilers into the path, in the Windows directory for exemple, or any
directory assigned to the path variable (see at autoexec.bat or equivalent).
You may also add the scriptol directory to list of paths.
The install.bat script install required file into sub-directories, or
into the directory given as argument. Under Unix, it is named setup.
Before to use the compiler, you have to read the licence, in the doc
directory: licence.html.


Using the Scriptol to native compiler

Just type:
    solc mysource
Type "solc" only to list the options.

If your program is a multi-file project, the source given as parameter must
be the main source file, the compiler will know dependencies from "include"
statements and will build what is needed.


Testing the examples

Type from the main scriptol directory:
   solc -bre demos\fibo


Configuring

By editing the solc.ini file, you may change the second pass compiler (you may
have to rebuild the libsol library for this compiler), change the options of
the compiler or add header files to include.
Predefined configuration files exists for common compiler:
  solc.bcc
  solc.gcc
  solc.ms
Just copy the right file over solc.ini.
To add header files, just add "header=someheader.hpp" lines into the config
file.
A xxx.cfg file may be written for each project main source beeing xxx, and if
present, it overloads the solc.ini file.

The cfg or the default ini file must be copied into the directory of the source to compile.

Need more details? Read the faq file on the Scriptol site:
 http://www.scriptol.com/faq.php
or send your questions at support@scriptol.com  (a form is also available
on the web).


Libraries for other compilers

They are available from scriptol.net or on the Scriptol CD.
Currently available:
- libsolbc.lib     for Borland C++
- libsolms.lib     for Microsoft's Visual C.
- libsol.a         for MingW 3.2
- libsol.a         for GCC 3.x


The additional libraries, gc.lib, jvm.lib, etc... are also available
in all formats.


Read the CONTENT file for more details on what is available in the archive.
