Re: [xmlroff] javadoc formatting ?

[Tony G. <Ton...@Su...>]

james anderson wrote at  7 Mar 2003 14:08:28 +0100:
 > is there a dtd/schema for the xml source document for your transformation to pdf? is it somewhere in the release?

There is a DTD for Javadoc XML, but AFAIK the whole Javadoc XML work
is experimental, and the DTD is not mine to make public.

The Javadoc XML example handles the Javadoc XML as well-formed XML
only.  The example stylesheet does not attempt to handle every
possible combination of the elements and attributes in the example XML
file.  It certainly doesn't attempt to handle every possible element
and attribute in a DTD that models all of Javadoc.

In fact, as noted in the README and on the Javadoc XML example web
page, the example presupposes some munging from real Javadoc XML to an
intermediate form that includes class names, etc., from what would
have originally been multiple Javadoc XML files.  As such, it's
unlikely that you'd want a DTD for the XML used as input to the
example stylesheet.

Regards,


Tony Graham
------------------------------------------------------------------------
XML Technology Center - Dublin
Sun Microsystems Ireland Ltd                       Phone: +353 1 8199708
Hamilton House, East Point Business Park, Dublin 3            x(70)19708