ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Dominique Devienne" <>
Subject Re: Custom task and type documentation revisited
Date Sat, 18 Mar 2006 14:00:21 GMT
On 3/17/06, Curt Arnold <> wrote:
> I'm doing my annual cpptasks (
> cleaning and expect to be producing long overdue release shortly and
> hopefully additional releases at more reasonable intervals.  The
> current cpptasks build uses tools from the proposals/xdocs to
> generate raw documentation from Javadoc comments in the source code
> which is then modified to create the product documentation.  I
> remember it as a fragile and complicated process and failed at my
> first half-hearted attempt to regenerate the documentation recently.
> While I expect that I could eventually get it back working again, I
> was wondering if something new and better had come along for
> generating task documentation.  If not, I'd still be tempted to
> migrate to javadoc + some doclet + XSLT to generate the documentation.

Curt, there's nothing tangible for that yet, but there is a lingering
attempt at defining the custom XML schema for the doc in SVN,
ant/sandbox/antlibs/gendoc, and this was discussed on the list a few
months back, and more recently with Kev Jackson. A general solution
would need to be merging automatically generated XML from the Java
source, with manually written XML for examples, use, etc...

But given that we have nothing, any javadoc + some doclet + XSLT
solution would be better IMHO. --DD

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message