Bug 1416038 (part 9) - Add a comment about nsISAXXMLReader's lack of functionality. r=erahm

--HG--
extra : rebase_source : 0e4e8ac0ce98efb497a62b3abd70b5a7d6914ad8
This commit is contained in:
Nicholas Nethercote 2017-11-10 15:23:27 +11:00
parent e9e330e914
commit c4d895d0d6

View File

@ -18,6 +18,12 @@ interface nsIMozSAXXMLDeclarationHandler;
/**
* Interface for reading an XML document using callbacks.
*
* NOTE: This file (and related ones) used to implement a full-featured SAX XML
* parser. But we have few uses of this interface and the ones we have only use
* a fraction of the full SAX functionality. So in bug 1416038 we removed a lot
* of it. See the changes associated with that bug if you need to reintroduce
* any of that functionality.
*
* nsISAXXMLReader is the interface that an XML parser's SAX2
* driver must implement. This interface allows an application to set
* and query features and properties in the parser, to register event