Represents the entire Javadoc Doclet API as a virtual XML document (called Data Source Model or Doclet DSM).

DSM Type is a mapping of the Doclet API classes and methods on DSM elements and attributes.

This is the second (current) version of such a mapping introduced since DocFlex/Javadoc v1.5.6. It is different from the old one just in a few places.

The reason why the new mapping (DSM Type) was needed is the support of the notion of parent element: a new GOMElement.parent property and findAncestor() function have been introduced. (Later, there will be also a special Location Path axis 'parent'.)

The notion of parent element is opposite to the notion of child element. If element1 is a child of element2, then element2 must be the parent of element1. In particular that means, given


element1 = element2.findChild ("SomeElementType");
the following must be true:

element1.parent.id == element2.id
For the old mapping, that is not always true (in all situations). The new DSM Type fixes this.