181 lines
6.7 KiB
Plaintext
181 lines
6.7 KiB
Plaintext
+----------------------------+
|
|
| STk 3.1 Installation notes |
|
|
+----------------------------+
|
|
|
|
|
|
IMPORTANT NOTE - IMPORTANT NOTE - IMPORTANT NOTE
|
|
------------------------------------------------
|
|
|
|
|
| STk bignums are implemented with the GNU mp APIs. This library provides a
|
|
| VERY EFFICIENT implementation of multiple precision numbers. This library
|
|
| is placed under the GNU GENERAL PUBLIC LICENSE. However, to avoid to fall
|
|
| under the restrictive GPL terms you can use the FGMP package (FGMP is a
|
|
| public domain implementation of a subset of the GNU gmp library with the
|
|
| same API, written by Mark Henderson <markh@wimsey.bc.ca>). This package
|
|
| has the advantage to be totally *FREE*, and the disadventage to be *SLOW*.
|
|
|
|
|
| So, if your concern is speed, and if the GPL is not a problem for you,
|
|
| use the Gnu package.
|
|
|
|
|
| Both package are in the distribution file. You don't need to ftp them.
|
|
|
|
|
---------------------------------------------------------------------
|
|
END OF IMPORTANT NOTE - END OF IMPORTANT NOTE - END OF IMPORTANT NOTE
|
|
|
|
|
|
To install this package:
|
|
|
|
*** 1. Configure the package for your system.
|
|
|
|
In the directory that this file is in, type
|
|
|
|
$ /bin/sh ./configure
|
|
|
|
This line runs the `configure' shell script. This script attempts to
|
|
guess correct values for various system-dependent variables used
|
|
during compilation, and creates various files necessary for package
|
|
building.
|
|
|
|
Default configuration will compile the package with the the "gcc"
|
|
compiler and the "-O2" option. This can be changed by changing the
|
|
default value of the CC and CFLAGS shell variables. For instance:
|
|
|
|
$ /bin/sh -c 'CC=another-cc CFLAGS="-O2 -g" ./configure'
|
|
|
|
will configure the package to use the "another-cc" compiler with
|
|
options "-O2" and "-g".
|
|
|
|
By default, `make install' will install the package's files in
|
|
/usr/local/bin, /usr/local/lib, /usr/local/man, etc. You can specify
|
|
an installation prefix other than /usr/local by giving `configure' the
|
|
option `--prefix=PATH'. For instance to place everything in the
|
|
directory whose name is 'another/place' You'll have to type
|
|
|
|
$ /bin/sh configure --prefix=/another/place
|
|
|
|
By default STk is compiled with the Gnu MP library. If using GNU
|
|
software is a problem for you you can specify to use the FGMP package
|
|
with the '--with-fgmp' option. Example:
|
|
|
|
$ /bin/sh configure --prefix=/another/place --with-fgmp
|
|
|
|
Several features can also specified at configuration time. To enable
|
|
the feature XXX you'll have to specify the '--enable-XXX'. Of course,
|
|
'--disable-XXX' permits to disable an option which is enabled by
|
|
default. The following table gives the list of possible features
|
|
available when compiling STk and their default value.
|
|
|
|
________________________________________________________________
|
|
| XXX | Default | |
|
|
| | value | |
|
|
|=============|=========|=======================================|
|
|
| hash | enabled | Compile support for hash tables |
|
|
|-------------|-------------------------------------------------|
|
|
| stklos | enabled | Compile support for stklos (requires |
|
|
| | | hash tables) |
|
|
|-------------|---------|---------------------------------------|
|
|
| socket | enabled | Compile support for sockets. |
|
|
|-------------|-------------------------------------------------|
|
|
| dynload | depends | Specifies if STk uses dynamic loading |
|
|
| | | for extensions. By default, dynamic |
|
|
| | | loading is enabled for systems which |
|
|
| | | support it (and for which support has |
|
|
| | | been integrated into the interpreter |
|
|
| | | This option permit to change this |
|
|
| | | default value. |
|
|
| | | See below for systems for which |
|
|
| | | dynamic loading support exists |
|
|
|-------------|-------------------------------------------------|
|
|
| elf | depends | Use it to enable or disable ELF |
|
|
| | | dynamic loading on Linux system. |
|
|
| | | Default value is choosen by the |
|
|
| | | configure script. If this value is |
|
|
| | | incorrect, use this option to toggle |
|
|
| | | it. This option works only on Linux |
|
|
| | | systems |
|
|
|-------------|-------------------------------------------------|
|
|
| pixmap [ enabled | Add pixmap support for Tk images |
|
|
| | | Use --with-pixmap=XXX if configure |
|
|
| | | can't locate your Xpm library. XXX |
|
|
| | | is the linking option you need for |
|
|
| | | using pixmaps. For example, |
|
|
| | | -with-pixmap='-L/home/X11 -lXpm' |
|
|
|-------------|-------------------------------------------------|
|
|
| html | enabled | Compile support for html |
|
|
|-------------|-------------------------------------------------|
|
|
| dld | disabled| Use it to enable synamic loading using|
|
|
| | | the DLD package (works on Linux only) |
|
|
|-------------|---------|---------------------------------------|
|
|
| regexp | enabled | Add support for regular expressions |
|
|
|-------------|---------|---------------------------------------|
|
|
| process | enabled | Add support for running processes from|
|
|
| | | the interpreter and redirecting their |
|
|
| | | IO |
|
|
|-------------|---------|---------------------------------------|
|
|
| posix | enabled | Add support for POSIX.1 functions. |
|
|
| | | Support is very incmplete but will |
|
|
| | | grow |
|
|
|_____________|_________|_______________________________________|
|
|
|
|
For instance
|
|
|
|
$ /bin/sh -c 'CC=gcc ./configure --with-fgmp \
|
|
--enable-socket --prefix=/scheme'
|
|
|
|
will configure the package to use the free bignum library and the socket
|
|
support . All the needed files will be installed in the /scheme/bin
|
|
/scheme/lib ... directories.
|
|
|
|
|
|
*** 2 . Compiling the package (and testing it)
|
|
|
|
Once configuration is done, just type
|
|
|
|
$ make
|
|
|
|
in this directory to make the whole system. Once the make is terminated you
|
|
can do a minimal test of stk with
|
|
|
|
$ (cd Src; /bin/sh test-stk)
|
|
|
|
This will bring a little squared window on your screen (if your DISPLAY
|
|
variable is correctly set). When this is done, enter the following line
|
|
|
|
(pack (button '.test :text "Hello, world" :command '(destroy *root*)))
|
|
|
|
at the scheme prompt. This will display an Hello world button. Clicking on it
|
|
will leave the scheme interpreter. A more complete demo can be obtained with:
|
|
|
|
$ make demos
|
|
|
|
This command runs the STk HTML browser on a file which allows you to launch
|
|
simply the demos located in the "Demos" directory.
|
|
|
|
|
|
|
|
*** 3. Documentation
|
|
|
|
Documentation is provided in Postscript and in TeX. To rebuild the
|
|
documentation, you'll have to type
|
|
|
|
$ make doc
|
|
|
|
This will rebuilt the Postscript documentation. To make only the
|
|
dvi files, use
|
|
|
|
$ make dvi
|
|
|
|
|
|
*** 4. Installation
|
|
|
|
To install stk in the definitive place, type
|
|
|
|
$ make install
|
|
|
|
Intalling STk and Tk manual pages is done with
|
|
|
|
$ make install.man
|
|
|
|
Have fun
|
|
|