Return-Path: Mailing-List: contact ant-user-help@jakarta.apache.org; run by ezmlm Delivered-To: mailing list ant-user@jakarta.apache.org Received: (qmail 54029 invoked from network); 17 Oct 2000 16:03:18 -0000 Received: from e34.co.us.ibm.com (HELO e34.esmtp.ibm.com) (32.97.110.132) by locus.apache.org with SMTP; 17 Oct 2000 16:03:18 -0000 Received: from westrelay02.boulder.ibm.com (westrelay02.boulder.ibm.com [9.99.132.205]) by e34.esmtp.ibm.com (8.9.3/8.9.3) with ESMTP id LAA118816; Tue, 17 Oct 2000 11:50:18 -0400 Received: from d25ml04.torolab.ibm.com (d25ml04.torolab.ibm.com [9.21.4.158]) by westrelay02.boulder.ibm.com (8.11.0m3/NCO v4.94) with ESMTP id e9HG3G271846; Tue, 17 Oct 2000 10:03:16 -0600 Importance: Normal Subject: Re: New doc format and organization To: ant-dev@jakarta.apache.org Cc: ant-user@jakarta.apache.org X-Mailer: Lotus Notes Release 5.0.3 (Intl) 21 March 2000 Message-ID: From: "Glenn McAllister" Date: Tue, 17 Oct 2000 12:03:58 -0400 X-MIMETrack: Serialize by Router on D25ML04/25/M/IBM(Release 5.0.4a |July 24, 2000) at 10/17/2000 12:03:16 PM MIME-Version: 1.0 Content-type: text/plain; charset=us-ascii X-Spam-Rating: locus.apache.org 1.6.2 0/1000/N I'm more than happy to move to an auto-generated format fairly quickly once we get by release 1.2. I just figured that the current style was getting a bit unworkable/unreadable, so I'd take a first stab a cleaning things up. Should I back off on this, then, and just wait till after 1.2? If I make a major change now, and then have to redo it all to suit some automated process, how much thrashing will that cause in CVS? I'm happy to continue, but I guess I'd like to have a better feel for the implications before I commit anything. P.S. I prefer .html too. I was using FrontPage to do some of this stuff more quickly, and it defaults to using .htm. I'll fix that. Glenn McAllister Software Developer. IBM Toronto Lab, (416) 448-3805 "An approximate answer to the right question is better than the right answer to the wrong question." - John W. Tukey Please respond to ant-dev@jakarta.apache.org To: ant-dev@jakarta.apache.org cc: ant-user@jakarta.apache.org Subject: Re: New doc format and organization >>>>> "GM" == Glenn McAllister writes: GM> So, I've gone for a more LDP format that has a primary table of GM> contents, with navigation links from one page to the next. This is almost calling for docbook or stylebook - and I wouldn't mind going into that direction. So, yes, I like it as an interim solution (the HTML files) but would prefer to autogenerate the HTML at a later point. GM> Now, I don't like this format as it introduces some maintenance GM> headaches. Obviously, most Next and Prev links are broken 8-). GM> Also, how do people feel about CSS? Even javadoc uses CSS (JDK 1.2+ that is) so I think we could do so as well. Stefan PS: I'd prefer .html over .htm