ant-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Dominique Devienne" <DDevie...@lgc.com>
Subject RE: Ant documentation
Date Wed, 09 Mar 2005 15:53:23 GMT
> From: Peter Reilly [mailto:peterreilly@apache.org]
> >In what I have in mind, examples are not text (or CDATA sections),
> >but actual XML, in order to keep the XML infoset, which is used to
> >do the syntax highlighting. And along with syntax highlighting, you
> >can add links to actual doc for all the attributes/elements used
> >in the examples!
> 
> Would XML name-space examples cause problems?

Not at all. You just have to declare them, as usual in XML.

They are actually necessary if you want to link the task name
in the HTML to the proper doc for the task. You need a mapping
from XML URI to base URL to map to, when documenting cross-
antlib examples.

My vision is that an AntLib writer can generate its doc the same
way Ant would (will ;-), mapping the Ant URI to the online manual.
This way antlibs' documentation become cross-linked.

Basically the same idea as in <javadoc>'s <link> and <linkoffline>.

--DD

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


Mime
View raw message