This distribution contains code for the S-Lang grace plotting module.
See the documentation in the doc/ directory for information about
using the module once it has been installed.

Grace is a popular plotting tool that produces publication quality
plots.  The S-Lang module interacts with grace via pipes.

To create the module, you will need at least version 2.1.x of the slang
library, which is available from <http://www.jedsoft.org/slang/>.
The module makes extensive use of qualifiers, which is not present in
earlier versions.

To use the module, your will need to have a recent version of the
grace installed.  The module was developed using grace-5.1.20; I do
not know how well this module will interact with older version of
grace, nor do I know how will it will work with development versions.
You can download grace from its web site at
<http://plasma-gate.weizmann.ac.il/Grace/>.  Debian users can install
grace using, e.g.,
             
	  apt-get install grace

You must run the configure script before you can compile the module.
If the slang library is installed in a non-standard location, then you
will need to specify the location of the library as arguments to the
configure script.  For example, suppose libslang.so is located in
/home/bill/lib/ and its include file slang.h is located in
/home/bill/include/. Then you would run the configure script using:

  ./configure --with-slanglib=/home/bill/lib \
              --with-slanginc=/home/bill/include

or, the shorter form which assumes a common pathname prefix for the
lib and include directories:

  ./configure --with-slang=/home/bill

You should also specify a location for the modules (*.so) and any
associated script (*.sl) files created by this package.  The default
location for the modules is in

   $prefix/lib/slang/modules/

Any .sl files will be installed in

   $exec_prefix/share/slsh/local-packages/

where the values of the variable $prefix defaults to /usr/local, and
that of $exec_prefix to the value of $prefix.  These values may be
changed using the --prefix and --exec-prefix configure script
parameters.  For example, to set the value of $prefix to /home/bill,
use

   ./configure --prefix=/home/bill ...

For more help using the configure script, run it using 

   ./configure --help

It is also a good idea to read the INSTALL.txt file located in this
directory.

Once the configure script has been run, you should inspect
the Makefile that it generated in the src directory.  Then building
and installing the library should involve nothing more than:

   make 
   make install

You may have to have root privileges to perform the last step. 
