SGML

Member Details

comment(text)

Called for every "pure" comment (an SGML markup declaration that contains entirely of a single comment).

Note this is the only type of comment supported by XML, whereas in SGML, a single markup declaration can have multiple comments. These type of comments are not delivered via this callback.

Parameters

Name	Type	Description
text	string	the character data comprising the comment

endCDATA()

Called to end the previously started CDATA marked section.

endDTD()

Called to demarcate the end of unparsedEntityDecl and notationDecl events associated with to declaration set of the most recent startDTD. event.

endEntity(name, elmt)

Called to end the previously started data or subdoc entity.

Parameters

Name	Type	Description
name	string	name of the data or subdoc entity
elmt	string	(optional) name of the element on which the entity was specified, if it was due to a linkhandler-expanded #CONREF entity

endIGNORE()

Called to end a previously started IGNORE marked section.

endINCLUDE()

Called to end a previously started INCLUDE marked section.

endRCDATA()

Called to end the previously started RCDATA marked section.

startCDATA(text)

Called on a CDATA marked section in input.

Parameters

Name	Type	Description
text	string	the characters comprising the CDATA marked section including surrounding "" markers; note that in standard SAX this argument isn't delivered (only begin an end of CDATA sections are demarcated) whereas character data in marked sections is delivered both via startCDATA() and with characters() events wrapped by start/endCDATA() calls

startDTD(name, publicid, systemid, text)

Called for every declaration set.

Will typically be called immediately after start_document(), if at all. Might also be called on artifical declaration sets emitted by Linkhandler for DAFE attributes.

startDTD() demarcates the begin of a (potentially empty) sequence of notationDecl and/or unparsedEntityDecl events that are declared (or generated) for the respective announced declaration set.

Parameters

Name	Type	Description
name	string	the name of the declaration set
publicid	string	the public identifier of the declaration set, if any
systemid	string	the system identifier of the declaration set, if any
text	string	the declaration set text including leading and trailing declaration set open delimiters; doesn't contain any terminating newline characters

startEntity(name, elmt)

Called on unexpanded data and SUBDOC entities.

Note: SUBDOC entities aren't supported in this release

Parameters

Name	Type	Description
name	string	name of the data or subdoc entity
elmt	string	(optional) name of the element on which the entity was specified, if it was due to a linkhandler-expanded #CONREF entity

startIGNORE(text)

Called on a marked section with IGNORE (or TEMP or absent) keyword in content.

Not called on marked sections in the document prolog.

Parameters

Name	Type	Description
text	string	the characters comprising the IGNORE marked section

See:

LexicalHandler#startCDATA

startINCLUDE(text)

Called on a marked section with INCLUDE (or TEMP or absent) keyword in content.

Not called on marked sections in the document prolog.

Parameters

Name	Type	Description
text	string	the characters comprising the INCLUDE marked section

See:

LexicalHandler#startCDATA

startRCDATA(text)

Called on a RCDATA marked section in input.

Parameters

Name	Type	Description
text	string	the characters comprising the RCDATA marked section

See:

LexicalHandler#startCDATA