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