[XERCESJ-67] Documentation of XMLDTDHandler.start/endEntity incorrect

• Type: Bug
• Status: Resolved
• Resolution: Fixed
• Affects Version/s: 2.0.0 [beta 3]
• Component/s: XNI
• Environment: Operating System: Windows NT/2K; Platform: Other
• Bugzilla Id: 5058
• Assignee: Unassigned
• Reporter: James Clark
• Created: 24/Nov/01 02:43
• Updated: 16/Feb/11 23:56
• Resolved: 13/Apr/04 00:59

Description

(This is beta3, but Bugzilla doesn't recognize that)

org.apache.xerces.xni.XMLDTDHandler.start/endEntity has a note

• <p>
• <strong>Note:</strong> Since the DTD is an entity, the handler
• will be notified of the end of the DTD entity by calling the
• endEntity method with the entity name "[dtd]" <em>after</em> calling
• the endDTD method.

This should be deleted. A DTD is not an entity it potentially has both an
internal subset and an external subset. The methods should get called as
follows:

startDTD()
calls for internal subset
startEntity("[dtd]")
calls for external subset
endEntity("[dtd]")
endDTD()

Fortunately this is what Xerces already appears to do.