Return-Path: Delivered-To: apmail-lucene-pylucene-dev-archive@minotaur.apache.org Received: (qmail 28894 invoked from network); 23 Apr 2009 17:45:36 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.3) by minotaur.apache.org with SMTP; 23 Apr 2009 17:45:36 -0000 Received: (qmail 4115 invoked by uid 500); 23 Apr 2009 17:45:36 -0000 Delivered-To: apmail-lucene-pylucene-dev-archive@lucene.apache.org Received: (qmail 4066 invoked by uid 500); 23 Apr 2009 17:45:36 -0000 Mailing-List: contact pylucene-dev-help@lucene.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: pylucene-dev@lucene.apache.org Delivered-To: mailing list pylucene-dev@lucene.apache.org Received: (qmail 4056 invoked by uid 99); 23 Apr 2009 17:45:36 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 23 Apr 2009 17:45:36 +0000 X-ASF-Spam-Status: No, hits=-4.0 required=10.0 tests=RCVD_IN_DNSWL_MED,SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (athena.apache.org: domain of janssen@parc.com designates 13.1.64.93 as permitted sender) Received: from [13.1.64.93] (HELO alpha.xerox.com) (13.1.64.93) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 23 Apr 2009 17:45:28 +0000 Received: from parc.com ([13.1.100.121]) by alpha.xerox.com with SMTP id <316728(2)>; Thu, 23 Apr 2009 10:44:32 PDT cc: pylucene-dev@lucene.apache.org To: Subject: installing pylucene-2.4.1 Date: Thu, 23 Apr 2009 10:44:32 PDT Message-ID: <52561.1240508672@parc.com> From: Bill Janssen X-Virus-Checked: Checked by ClamAV on apache.org I've just tried installing 2.4.1, and I've got a few suggestions for packaging. 1. Put a plain-text version of readme.html in README, automatically generated from readme.html (or whatever), as part of the src-dist build process. I always hate it when I visit a README, and it says, "You fool! You should be looking at doc/documentation/readme.html!" 2. Ditto for the INSTALL file. 3. Oh, and by the way, looking at readme.html is tough. The string "doc/documentation/readme.html" will almost always be read as just "documentation/readme.html". I'd suggest calling that directory "doc/dist", or some such, instead of "doc/documentation". 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". 5. Get rid of editing the Makefile, if you can. Would you like me to write an autoconf script for this? Bill