Mailing-List: contact dev-help@ant.apache.org; run by ezmlm
Precedence: bulk
Reply-To: "Ant Developers List" <dev@ant.apache.org>
Received-SPF: pass (hermes.apache.org: local policy)
To: dev@ant.apache.org
Subject: Re: Prototype work on XML+XSL based Ant doc
References: 
 <A672996F85AA7240A9DD2A455BD0D4288782E1@HOUEXCH902.Landmark.lgc.com>
From: Stefan Bodewig <bodewig@apache.org>
Date: Thu, 24 Mar 2005 08:28:40 +0100
Message-ID: <m3ll8dy02f.fsf@bodewig.bost.de>
User-Agent: Gnus/5.1006 (Gnus v5.10.6) XEmacs/21.4 (Security Through
 Obscurity, linux)
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii

On Tue, 22 Mar 2005, Dominique Devienne <DDevienne@lgc.com> wrote:

> I have several questions I was hoping could be discussed.

I'm glad you bring the discussion over here since I find it easier to
respond to an email using my mail client than my browser.

> 1) First, is there a place for such a prototype somewhere? 
> proposals/ in CVS?

Why not.

> Wait for SVN/ant/sandbox?

I could ping infrastructure to create /repos/asf/ant and we can go
from there immediately.  Right now all almost all our infrastructure
people are busy with something they call infrathon, though.  After
Easter?

> 2) Second, is the XML syntax I used too verbose?

No, I like it.

> Is what I used already good enough? Where to improve?

Let me echo Jan's wish for cross linking of tasks - both inside of
whatsnew and inside of the manual.

One thing that wasn't immediately clear to me was what the equivalent
of the <td rowspan="2">Exactly one of the two</td> cells we have in
the "required" column of some pages would be.

One thing that doesn't render well in Firefox is the since attribute
on the target and propertyset nested elements in ant.xml - I see the
&nbsp;s as text, i.e. Firefox seems to either escape the ampersand or
doesn't recognize it as entity.  I tried to change the output-method
to xhtml but Firefox doesn't recognize it.

> 3) Then, is DTD/Schema support important?

Not to me, YMMV.

> I'm basically trying to avoid this work going too much further if
> there's no buy in and support right at the start.

Understandable, see Kev's work of trying to lift stuff from HTML to
docbook.

> So far we've mostly discussed options, but with this initial
> 'implementation', I'd rather get a feel whether it's a dead end or
> not.

I like it and don't think it would make autogeneration later any more
difficult than what we have right now.  Probably it would make it
easier since we'd have computable semantics in our docs.

Stefan

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@ant.apache.org
For additional commands, e-mail: dev-help@ant.apache.org