On Apr 23, 2009, at 13:15, Bill Janssen <jans...@parc.com> wrote:

Andi Vajda <va...@apache.org> wrote:

If Apache Forrest, which is used to produce the web site, can be used to generate plain text, then this should be used for sure. What I don't want
to do is maintain two versions of the docs, even one pagers.

No, of course not.  That's why I use ReST for the UpLib docs.  I know
nothing about Apache Forrest.

Apache Forrest is what is used on the Apache Lucene site. I had to learn enough about it to get what we have today on the PyLucene site. I know that it makes a PDF page for every web page. Maybe it can make a plain text page too ?

4. If there's a top-level "build.xml" file, lots of users (me, too :-) will think that they can just type "ant" to build the package. That
  should either "just work", or you should rename the build.xml file
to something less obvious, like "to-be-invoked-by-the- Makefile.xml".

Renaming build.xml to something more obscure could be done.
Would you like to send in a patch ?

Didn't I just do that :-?  No, I'll let you deal with it.

Sadly, the alternative here is autoconf. If you'd like to write an autoconf script that works for all the variants of Python/Java/OS currently supported
in the Makefile, that would be excellent.

Yes, I've already got most of that for UpLib.

Unless you're on Mac, editing JCC's setup.py is also required. If you write an autoconf script for PyLucene, be sure to also include the generation of
JCC's setup.py, otherwise you've only addressed half of the problem.

Right.

I expect that cracking the nut of finding the JDK on each and every Linux distro is going to present a challenge. Providing command line arguments to
override what configure finds is probably a must.

Exactly.  Linux/Java is a mess -- whoops, I meant to say, a seething
ferment of opportunity! I've got a script called "figure-linux- java.py".

Nice !

Andi..



Bill

Reply via email to