
  INSTALL file for PyLucene with JCC build
  ----------------------------------------

  Contents
  --------

   - Building PyLucene
   - Requirements
   - Notes for Solaris


  Building PyLucene
  -----------------

  PyLucene is now completely code-generated by JCC whose sources are
  included in the jcc sub-directory.

  Before building PyLucene, JCC must be built first. See JCC's INSTALL file
  in the jcc subdirectory for building and installing it.

  Once JCC is built and installed, PyLucene is built via a Makefile which
  invokes JCC. See PyLucene's Makefile for configuration instructions.

  There are limits to both how many files can fit on the command line and
  how large a C++ file the C++ compiler can handle.
  By default, JCC generates one large C++ file containing the source code
  for all wrapper classes.

  Using the --files command line argument, this behaviour can be tuned to
  workaround various limits:
  for example:
     - to break up the large wrapper class file into about 2 files:
       --files 2
     - to break up the large wrapper class file into about 10 files:
       --files 10    
     - to generate one C++ file per Java class wrapped:
       --files separate


  Requirements
  ------------

  PyLucene with JCC has been built and tested on:

     - Intel Mac OS X 10.4.10 with Python 2.5.1 and Java 1.5
     - Intel Mac OS X 10.4.10 with Python 2.3.5. and Java 1.5
     - PowerPC Mac OS X 10.4.10 with Python 2.5.1. and Java 1.5
     - Ubuntu Linux 6.06 with Python 2.4.3 and Sun Java 1.5
     - Windows 2000 with Python 2.5.1 and Sun Java 1.6
     - Solaris 11 with Python 2.4 32-bit, Java 1.6 and Sun Studio C++ 12

  It is expected that PyLucene with JCC should pose little or no problems
  being built and run on Mac OS X 10.3, Java 1.2, 1.3 or 1.4, other Linux
  distributions, or Windows XP.

  To build PyLucene with JCC a Java Development Kit (JDK) and ant [1] are
  required; use of the resulting PyLucene requires only a Java Runtime
  Environment (JRE).

  The setuptools package [2] is required to build and run PyLucene with JCC
  on Python 2.3.5. With later versions of Python, setuptools is not required.

  [1] http://ant.apache.org
  [2] http://pypi.python.org/pypi/setuptools


  Notes for Solaris
  -----------------

  PyLucene's Makefile is a GNU Makefile. Be sure to use 'gmake' instead of
  plain 'make'.

  Just as when building JCC, Python's distutils must be nudged a bit to
  invoke the correct compiler. Sun Studio's C compiler is called 'cc' while
  its C++ compiler is called 'CC'.

  To build PyLucene, use the following shell command to ensure that the C++
  compiler is used: 

   $ CC=CC gmake
