Generating DTD Documentation

You can automatically generate XHTML documentation for any DTD files that are mounted in the IDE. The documentation describes each of the element declarations in your DTD, including its declared attributes, element content model, and the elements by which it is referenced.

You can add additional information to an element declaration's description by inserting a DTDDoc comment before the element declaration in the DTD. DTDDoc comments have a normal comment tag with three minus characters (-) instead of two. You can format the DTDDoc comment's appearance by using any XHTML tags allowed by the <DIV> element, as shown in the following example:

<!--- <b>The root element:</b>
<ul><li>Contains one or more item elements.</li>
<li>Sets attributes for item elements.</li></ul>
-->
<!ELEMENT root ANY>

To generate documentation for a DTD file:

  1. Add DTDDoc comments into your DTD if necessary.
  2. Right-click the DTD node in the Explorer and choose Generate Documentation.
  3. Enter a filename for the documentation file in the dialog box and click OK.
See also
The XML Module
Creating an XML Document
Editing an XML Document
Text Editor
Tree Editor

Legal Notices