Name: dk30142 Date: 02/20/2003


This is part of the doclet toolkit implementation for Tiger.
It is not part of the Java platform APIs.

Proposed package name:
com.sun.tools.doclet.toolkit.util.doccommentdom
or
com.sun.tools.doclet.toolkit.util.commentdom

DocComment to DOM Translator - Documentation comment contains
embedded HTML, Javadoc inline tags as well as custom inline tags.
This package will contain classes that will help generate a
DOM tree for the documentation comment. This can be of great
help for doclets that generate documentation in formats other
than HTML. Such doclets don t have to undergo the tedious task
of parsing the documentation comments for all the tags.
Doclets can then directly traverse the DOM tree and then
convert the tags to appropriate format. The DOM tree will
adhere to the doccomment DTD that will be published later.
The DTD will allow required HTML tags along with their
attributes as defined in HTML4.0 specifications. The DTD
will also support Javadoc-defined inline tags as well as
user-defined custom inline tags.
======================================================================