On Jun 29, 2011, at 18:16, Bill Janssen <jans...@parc.com> wrote: > Andi Vajda <va...@apache.org> wrote: > >> On Jun 29, 2011, at 16:43, Bill Janssen <jans...@parc.com> wrote: >> >>> Andi Vajda <va...@apache.org> wrote: >>> >>>>> By the way, you might want to add a paragraph in that section about >>>>> adding the ["-framework", "Python"] flags for building JCC on OS X. I >>>>> tripped over that again. >>>> >>>> If you send a paragraph to this effect, I'll integrate it into the docs. >>> >>> How do you feel about adding javadocs for the Java API, too? If I write >>> it, that is? >> >> You mean adding docs in the java source code ? > > Only partially. I also meant adding a build step which creates the > javadocs from the in-source documentation, and making those javadocs > part of the distribution, and adding those pre-built docs to the Apache > Web site.
That's more work but is feasible too. > Without the other part, I'm not that incentivized to add docs to the > source code, which is pretty easy to read by itself. I didn't bother for that reason and because there is so little Java code. In fact, there is more under PyLucene, still. That being said, if you send in javadoc patches, I agree, the results should be published like they are on the lucene/java site (under resources) and I can take care of that. Andi.. > > Bill
