                             GraphPs

GraphPs is an Objective Caml library that provides a module that can
be substituted to the usual graphics drawings module Graphics,
available from the Caml distribution. GraphPs provides a module also
named Graphics, that has (almost) the same signature as the original
Graphics module. Using the GraphPs Graphics module, your Caml drawing
programs generate PostScript files (that can be encapsulated into tex
or latex files), instead of drawing graphics directly onto the screen.

See the README file for more information.

 Usage
 -----

 When compiling a file that uses the GraphPs's version of module
Graphics, just add $(LIBDIR)/graphps to the search path of the Caml
compiler (where $(LIBDIR) is the absolute path of the directory where
the sub-directory graphps has been installed). Also, link with the
compiled graphics object file provided by the library:

$(LIBDIR)/graphps/graphics.cmo (for bytecode link) or
$(LIBDIR)/graphps/graphics.cmx (for native code link).

Have a look at test/Makefile for examples.

*** Requirements

 To install Graphps, you need ocaml 3.0 or higher

*** Installation procedure

 Compilation
 -----------
  In the graphps source directory, type 

	% make

 Test
 ----
  Before you actually install the library, you can check that it
really works, by running examples in the test directory. For the test
programs,

	% cd test
	% make
	% ./runtest

This requires a PostScript previsualisation program (e.g. ghstview or
gv) to be accessible from the current commands access path.

 Installation
 ------------ 
  If there is no compilation error and the test works fine, install
the library,

       -- Edit the Makefile.config file to specify the directory where
you want GraphPS to be installed (default is /usr/local/lib/ocaml).

       -- then type
       % make install

This command installs all the required files into the directory
specified by the variable $(LIBDIR) in the Makefile.config file
(this will default to /usr/local/lib/ocaml/graphps). You can change
this directory by editing Makefile.config (this directory would
presumably be the graphps sub-directory of the current Objective Caml
installation directory (usually /usr/local/lib/ocaml/ or /usr/lib/ocaml)).

 Native code version
 -------------------
  To compile and install the native code version of the library, type

	% make opt

and

	% make installopt

