Return-Path: Delivered-To: apmail-ant-dev-archive@www.apache.org Received: (qmail 44083 invoked from network); 7 Mar 2005 12:55:15 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur-2.apache.org with SMTP; 7 Mar 2005 12:55:15 -0000 Received: (qmail 78456 invoked by uid 500); 7 Mar 2005 12:55:14 -0000 Delivered-To: apmail-ant-dev-archive@ant.apache.org Received: (qmail 78387 invoked by uid 500); 7 Mar 2005 12:55:13 -0000 Mailing-List: contact dev-help@ant.apache.org; run by ezmlm Precedence: bulk List-Unsubscribe: List-Subscribe: List-Help: List-Post: List-Id: "Ant Developers List" Reply-To: "Ant Developers List" Delivered-To: mailing list dev@ant.apache.org Received: (qmail 78364 invoked by uid 99); 7 Mar 2005 12:55:13 -0000 X-ASF-Spam-Status: No, hits=0.0 required=10.0 tests= X-Spam-Check-By: apache.org Received-SPF: neutral (hermes.apache.org: local policy) Received: from colossus.hpl.hp.com (HELO colossus.hpl.hp.com) (192.6.10.2) by apache.org (qpsmtpd/0.28) with ESMTP; Mon, 07 Mar 2005 04:55:12 -0800 Received: from timmay.hpl.hp.com (timmay-hb.hpl.hp.com [15.144.59.39]) by colossus.hpl.hp.com (8.12.10/8.12.10) with ESMTP id j27CsJjk005344 for ; Mon, 7 Mar 2005 12:54:19 GMT Received: from [15.144.25.135] (chamonix.hpl.hp.com [15.144.25.135]) by timmay.hpl.hp.com (8.13.2/8.13.2) with ESMTP id j27CsFEJ024106 for ; Mon, 7 Mar 2005 12:54:15 GMT Message-ID: <422C4EF7.8060609@apache.org> Date: Mon, 07 Mar 2005 12:54:15 +0000 From: Steve Loughran User-Agent: Mozilla Thunderbird 0.7 (X11/20040615) X-Accept-Language: en-us, en MIME-Version: 1.0 To: Ant Developers List Subject: Re: Ant documentation References: <42253E51.8010905@it.fts-vn.com> In-Reply-To: Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit X-HPLB-IMAP-MailScanner-Information: Please contact the Helpdesk for more information X-HPLB-IMAP-MailScanner: Found to be clean X-HPLB-IMAP-MailScanner-SpamCheck: not spam, SpamAssassin (score=0, required 5) X-HPL-MailScanner-Information: Please contact the Helpdesk for more information X-HPL-MailScanner: Found to be clean X-HPL-MailScanner-SpamCheck: not spam, SpamAssassin (score=-1.245, required 5, autolearn=not spam, ALL_TRUSTED -0.84, AWL -0.40) X-MailScanner-From: stevel@apache.org X-Virus-Checked: Checked X-Spam-Rating: minotaur-2.apache.org 1.6.2 0/1000/N Stefan Bodewig wrote: > On Wed, 02 Mar 2005, Kev Jackson wrote: > > >>Thoughts/comments more than welcome > > > Being a LaTeX guy myself, I've grown some bad feelings towards docbook > when I had to use it on one project. It's so powerless in > comparision, but maybe that's only due to the default stylesheets and > could be improved by better styles (something I have no desire to work > on). I tried to use docbook and ended up hating it too. Not enough macros see, you may be describing structure rather than style , but what I want is and , independent of the structure to use. Also, as it doesnt cross-ref across docs, it is not as good as bibtex. I have stopped using it for now; it is not for humans to edit. > > Anyway, docbook is not worse than HTML, only that people will have to > learn it in order to contribute to the docs. I'm not 100% sure that > I'd want to go that route. acutally it is worse in that the time from entry to view is longer; at least with (X)HTML you can hit reload and view the result immediately Also: too verbose, paragraph logic too complex, not enough people know it. > > Having the xdocs stuff output the docs as docbook instead of HTML > would be fine. But maybe it would be easier to create PDFs using FOP > from the output the xdocs proposal currently creates. dunno about the existing output. But we could go straight to Latex if we wanted :) --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org For additional commands, e-mail: dev-help@ant.apache.org