Javadoc Schema
This schema is designed as a centerpiece for an improved Javadoc Doclet. With an XSLT processor, it will be much easier to generate multiple document formats than with the current Doclet system. Eventually, I hope to expand the Doclet to allow for more flexibility on the input side. Like, allowing for a structured text syntax as well as the default HTML-style syntax.
I’m kind of disappointed Sun hasn’t done this by now. It seems like the logical way to handle Javadoc, especially now that JAXP is around.
- javadoc.xsd
- The Javadoc schema file.
- javadoc.dtd (non-normative)
- A DTD for those who prefer them. This may not be used for validation.
- javadoc.css
- An ugly stylesheet, used so I can check the structure while I work on the schema.
- javadoc-xhtml.xsl
- An XSLT file to transform the document into a structure similar to the usual Javadoc HTML, but XHTML 1.1 compliant.
And here are some examples:
- Pieces from a structured text engine