
		          LiSP2TeX

                      Christian Queinnec
           \'Ecole Polytechnique & INRIA--Rocquencourt

Bug descriptions, use reports, comments or suggestions are welcome.
Send them to:                    or to:
  Christian Queinnec                     Christian Queinnec
  <queinnec@polytechnique.fr>            <Christian.Queinnec@inria.fr>
  Laboratoire d'Informatique de l'X      INRIA -- Rocquencourt
  Ecole Polytechnique                    Domaine de Voluceau, BP 105
  91128 Palaiseau                        78153 Le Chesnay Cedex
  France                                 France

LiSP2TeX is a utility program to insert Lisp or Scheme code within TeX
files.  It is written in Scheme and can be compiled into a stand-alone
program with Scheme->C or Bigloo. The latter is the faster.

For the installation, you need to look at the beginning of the
Makefile to set up various parameters driving the compilation and
installation. Among these variables, set up the HOSTTYPE variable
unless you use tcsh which sets up automatically. The Makefile will
complain if absent. 

* * * * * * * * * * * * * * * * * * * * * * * Scheme->C installation:
  Joel Bartlett wrote Scheme->C that can be retrieved by anonymous ftp
from gatekeeper.dec.com:pub/DEC/Scheme-to-C. If you have Scheme->C,
adapt the paths that appear in the Makefile (if needed) and try

        make SCM=s2c

* * * * * * * * * * * * * * * * * * * * * * * Bigloo installation:
  Manuel Serrano wrote Bigloo that can be retrieved by anonymous ftp
from ftp.inria.fr:INRIA/Projects/icsla. You need at least Bigloo 1.4
for that installation. If you have Bigloo, adapt the paths that appear
in the Makefile (if needed) and try

        make SCM=bigloo

* * * * * * * * * * * * * * * * * * * * * * * End of installation:
The Makefile rebuilds what is needed and try to install LiSPTeX in the
usual shared directories /usr/local/bin and the others (see the beginning 
of the Makefile for details). If you are not root then it is time to su 
and to run make again. 

	su root
	make install
	exit

It will normally install LiSP2TeX in /usr/local/bin, a man page in
/usr/man/man1, a (La)TeX style in /usr/local/lib/tex/inputs and some
documentation as well as customisation files in a common directory
named /usr/local/lib/LiSP2TeX.

* * * * * * * * * * * * * * * * * * * * * * * Miscellaneous:
Adaptations for LiSP2TeX are gathered in files port-*.scm. If you write
such an adaptation, then send it to me so I can incorporate it in the
next release of LiSP2TeX. [One for PC-Scheme is almost finished]

Some customization files (ending with .mkgreek) are provided in the
distribution, if you write such files that you are proud of, send them
to me, I will incorporate them in a contrib directory.

   Have fun!

end of README.
