lucene-java-user mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From (Steven J. Owens)
Subject Re: compile lucene-1.2-rc2
Date Fri, 02 Nov 2001 19:11:12 GMT
[ Charset ISO-8859-1 unsupported, converting... ]
> This looks like a good start for a top-level README.txt, which we need
> before the 1.2 final.  Besides build instructions, this should include
> pointers to the documentation.  Anything else folks can think of?
> One correction: We should not mention downloading JavaCC, just ant and
> ant-optional.jar.
> Anyone want to draft the README.txt?

     I'll try to spend a couple hours on this later today.  I checked
out the jarkarta-lucene CVS archive last night to start playing with
the thread-safe version.  Might as well build it from scratch.  

     What is your goal for the README.txt?  Maybe it should point to
"build.txt" for build-from-checkout directions, another file for using
the .jar version, and another for the demo stuff?

     Okay, I went ahead and wrote a rough draft (included below).
But I have to do a bit more fiddling before I'm done.  I have two
questions; one, what version(s) of Ant does Lucene require, and two,
what versions of java can Lucene be built with and run with?

     As you'll see if you read all of the following, my initial
attempt at following these instructions failed.  The
and the build.xml look for a "jarkata-site2" directory parallel to the
checkout directory.  I'm going to save this, go back to the mailing
list, and reread the recent messages to see if this is addresesd.

Build Instructions for Lucene-1.2-rc2

Basic steps:
     0) download lucene-1.2-rc2 from the Apache Project
     1) set up the JDK, Ant, and the Ant optional.jar
     2) cd into the top folder of the jakarta-lucene checkout
     3) run ant

Step 0) download lucene-1.2-rc2 from the Apache Project

     We'll assume you already did Step 0, or you wouldn't be reading
this file.  However, you might have received this file by some
alternate route, or you might have an incomplete copy of the Lucene,

     Lucene 1.2-rc2 is available for download at:

     Download either a zip or a tarred/gzipped version of the archive,
and uncompress it into a directory of your choice.

Step 1) Set up your development environment (JDK, Ant, Ant optional jar).

     We'll assume that you know how to get and set up the JDK - if you
don't, then we suggest starting at and learning more
about Java, before returning to this README.

     Lucene works with JDK 1.3.  Lucene works with earlier versions of
Java (WHICH VERSIONS?).  However, if you're going to work with the
development version of Lucene, we recommend you stick with the most
current version of Java.

     Lucene uses Apache Ant, like most of the Jakarta projects, for
build control.  Ant is "kind of like make without make's wrinkles".
Ant is implemented in java and uses XML-based configuration files.
You can get it at:

     Specifically, you can get the binary distributions at:

     (AGAIN, WHICH VERSIONS OF ANT?  Obviously recommend the latest
version, but does it work with any earlier versions?)

     You'll need to download both the Ant binary distribution 
optional jar file.  Install the binary distribution according to
the instructions under the "Installing Ant" link at:

Step 3) Cd into the top folder of the jarkata-lucene checkout.

     The top directory of the checkout contains the
and build.xml files.  You don't need to change any of the settings in
these files, but you do need to run ant from this location so it knows
where to find them.

Step 4) Run ant.

     Assuming you have ant in your PATH and both of the ant jars (the
main jar and the optional jar) in your CLASSPATH, simply entering
"ant" at the shell prompt and command prompt should invoke ant, and
ant will by default look for the "build.xml" file in your current
directory, where it should find it.

     Okay, so this first draft didn't work out so well.  I just followed
my own instructions and I got:

$ ant
Buildfile: build.xml


C:\cygwin\home\Administrator\jakarta-lucene\build.xml:29: C:\cygwin\home\Administrator\jakarta-site2\lib
not found.

Total time: 2 seconds

     Back to the drawing board, I'll have to check the list for recent
comments about this and see what I'm doing wrong.

Steven J. Owens

To unsubscribe, e-mail:   <>
For additional commands, e-mail: <>

View raw message