Bug 28446 - Annotation or documentation nodes
Summary: Annotation or documentation nodes
Status: NEW
Alias: None
Product: Ant
Classification: Unclassified
Component: Core (show other bugs)
Version: 1.6.1
Hardware: All All
: P3 enhancement (vote)
Target Milestone: ---
Assignee: Ant Notifications List
Depends on:
Reported: 2004-04-17 02:38 UTC by Matt Harrah
Modified: 2008-11-24 03:58 UTC (History)
0 users


Note You need to log in before you can comment on or make changes to this bug.
Description Matt Harrah 2004-04-17 02:38:00 UTC
We like to use XSLT over our build files to generate documentation of our 
build scripts.  Currently we have defined a macrodef called documentation that 
takes a type attribute (such as "usage", "example", "introduction", etc.) and 
a content attribute ("text" or "html"), but doesn't do anything at all.  We 
then use the macro in various places to document what we are doing.

However, to use this inside a macrodef, we have to put it inside the 
sequential section instead of in the macrodef header.

It would be nice if there were a built-in ability to put in a <documentation 
type="foo" content="bar"> type of construct anywhere in your build script.  
This would allow tools to get documentation of the script without having to 
parse XML comments.