* Installation

  It is vital to apply the patch provided in
  patches/tolua-4.0a-patch to tolua 4.0a. Without it, tklua will not
  work properly, due to a bug in tolua 4.0a.

  tolua 4.0 was written by Waldemar Celes. The alpha release is available at
           ftp://ftp.tecgraf.puc-rio.br/pub/celes/tolua/tolua-4.0a.tar.gz

  A later version of tolua 4.0 may be available by the time you read these
  instructions. In this case, applying the patch may not be necessary anymore.
  If in doubt, feel free to contact me at cvogler@gradient.cis.upenn.edu.
  
  To apply the patch:
	1. Change to the top-level directory of tolua. 
        2. Type patch -p0 < your-path-here/patches/tolua-4.0a-patch
  
        where your-path-here is the path to the tklua top-level directory.

  If the patch is applied successfully, you should see the message
  patching file `src/lib/tolua_gp.c' 
  and nothing else.

  Then recompile and re-install tolua, as per the instructions in the tolua
  top-level directory.

  If you would like to enable OpenGL support, you also need the
  inofficial partial port of gllua to the lua 4.0 API. It is available at
	ftp://ftp.cis.upenn.edu/pub/cvogler/software/gllua.tar.gz

  This gllua port is only a stopgap measure until the official port by
  Waldemar Celes becomes available. When that time comes, I will also provide
  an updated version of tklua as soon as possible.

  Now building tklua on a Unix system should be very easy:

	1. Edit "config" to suit your platform, if at all necessary.
	2. Then, type "make".

  See below for instructions for Windows.

* What you get

  If "make" succeeds, you get:
	* a simple tklua interpreter in ./bin;
	* the C library to be linked in your application in ./lib;
	* the include file needed to compile your application in ./include.
  These are the only directories you need for development.
  To generate executables, you need the following libraries,
  besides the tklua lib: tolua 3.0, lua 3.1, tk 8.0, tcl 8.0.
  If you plan to use OpenGL, you also need gllua and the OpenGL libraries.

  There is a manual page in html in ./doc and some sample code in ./test.
  You don't need these directories for development.

* Installation on Windows

  The instructions for building tklua on Windows machine depend on
  the particular compiler you are using.
  The simplest way is to create a folder with all .c and .h files, and
  then create a project for the executable and the library, as follows:

  tklua.exe: all *.c *.h in src/bin.
  tklua.lib: all *.c *.h in src/lib.

  Note: Building tklua 4.0a1 is untested on Windows. If you get it to work,
  please drop me a message at cvogler@gradient.cis.upenn.edu.
