2.1 Installing SpreadScript

SpreadScript 1.1 is distributed in a standard GNU ``gzipped tar'' archive named spreadscript-1.1-platform.tar.gz, where platform is ``i586-linux'' or ``solaris.'' Unpack the archive in a temporary directory using the ``tar'' command, for example:

gunzip spreadscript-1.1-i586-linux.tar.gz
tar xvf spreadscript-1.1-i586-linux.tar

The contents of the distribution will be unpacked into a sudirectory named spreadscript-i586-linux. You must ``cd'' into this directory to complete the installation.

In order to build and install SpreadScript, the package needs to learn about your system. The ``configure'' script tries to determine the locations of Perl, Python, Tcl, and their associated files. Normally, you can just run ``./configure'' at the command prompt, and the script will find everything it needs automatically.

The following options are available if you need to alter the script's behavior.

--without-python

Do not build python module. Tells the configure script not to configure Python support.

--with-pythonpath=path

Set location of python executable. Tells the configure script the location of the python executable; e.g., --with-pythonpath=/opt/python152/python.

--without-tcl

Do not build tcl module. Tells the configure script not to configure Tcl support.

--with-tclpath=path

Set location of tclsh executable. Tells the configure script the location of the tclsh executable; e.g., --with-tclpath=/opt/tcl8/tclsh.

--with-tclincl=path

Set location of Tcl include directory. Tells the configure script the location of the file ``tcl.h''; e.g., --with-tclincl=/opt/tcl8/include.

--without-perl

Do not build perl module. Tells the configure script not to configure Perl support.

--with-perlpath=path

Set location of Perl5 executable. Tells the configure script the location of the perl executable; e.g., --with-perlpath=/opt/perl5/perl.

By default, SpreadScript will be installed in /opt/SpreadScript. If you wish to use a directory other than /opt, you may use the --prefix option with configure in order to install SpreadScript in another directory. You may use the --exec_prefix to have SpreadScript install the SpreadScript shared library some place other than the default /usr/lib. Run ``configure --help'' for a full list of options.

After running the configure script, run ``make'' at the command prompt. This will compile support for the scripting languages. If ``make'' fails, either run the configure script again using the options above to tell it the locations of missing items or exclude the problem language using the --without-lang option if that language is not needed. The configure script will not put language support in the makefiles for languages it cannot find.

Finally, run as root ``make install'' at the command prompt. Using the information obtained by the configure script, the language support files are placed in the proper directories. The files in the SpreadScript distribution reside in the /opt/SpreadScript directory after installation (unless you changed the location using the --prefix option with the configure script).

You are now ready to try it out! Change to the ``samples'' subdirectory and run one or more the sample scripts. For example, run ``perl simple.pl'' at the command prompt. Then, take a look at the source for the scripts to quickly get up to speed on how to write scripts using SpreadScript. To run all of the simple.* scripts, execute the ``runsamples.sh'' script. (Note: You will need a SpreadScript license file to run the sample applications.)

When running SpreadScript with the developer edition license, SpreadScript adds an extra worksheet called "Created with SpreadScript" to each saved workbook. SpreadScript does not add that worksheet when it is used with a deployment license.

If you need to uninstall SpreadScript, run ``make uninstall'' at the command prompt. Once you are satisfied with your SpreadScript installation, you may remove the temporary directory.