[XML-SIG] SAX2: LexicalHandler

[Lars Marius Garshol]

This handler is supposed to be used by applications that need
information about lexical details in the document such as comments and
entity boundaries. Most applications won't need this, but the DOM will
find it useful. Support for this handler will be optional.

This handler has the handerID http://xml.org/sax/handlers/lexical.

class LexicalHandler:

  def xmlDecl(self, version, encoding, standalone):
    """All three parameters are strings. encoding and standalone are not
    specified on the XML declaration, their values will be None."""

  def startDTD(self, root, publicID, systemID):
    """This event is reported when the DOCTYPE declaration is
    encountered. root is the name of the root element type, while the two last
    parameters are the public and system identifiers of the external
    DTD subset."""

  def endDTD(self):
    "This event is reported after the DTD has been parsed."

  def startEntity(self, name):
    """Reports the beginning of a new entity. If the entity is the
    external DTD subset the name will be '[dtd]'."""

  def endEntity(self, name):
    pass

  def startCDATA(self):
    pass

  def endCDATA(self):
    pass