Merge from PyXML:

loewis · loewis · commit 46e7df2a0dca · 2002-06-30T07:38:50.000Z
[1.3] Added documentation of the namespace URI for elements with no namespace. [1.4] New property http://www.python.org/sax/properties/encoding. [1.5] Support optional string interning in pyexpat. git-svn-id: http://svn.python.org/projects/python/trunk@27436 6015fed2-1504-0410-9fe1-9d1591cc4771
diff --git a/Lib/xml/sax/handler.py b/Lib/xml/sax/handler.py
@@ -144,7 +144,10 @@ def startElementNS(self, name, qname, attrs):
         (uri, localname) tuple, the qname parameter the raw XML 1.0
         name used in the source document, and the attrs parameter
         holds an instance of the Attributes class containing the
-        attributes of the element."""
+        attributes of the element.
+
+        The uri part of the name tuple is None for elements which have
+        no namespace."""
 
     def endElementNS(self, name, qname):
         """Signals the end of an element in namespace mode.
@@ -315,7 +318,28 @@ def resolveEntity(self, publicId, systemId):
 #              the current event.
 # access: read-only
 
+property_encoding = "http://www.python.org/sax/properties/encoding"
+# data type: String
+# description: The name of the encoding to assume for input data.
+# access: write: set the encoding, e.g. established by a higher-level
+#                protocol. May change during parsing (e.g. after
+#                processing a META tag)
+#         read:  return the current encoding (possibly established through
+#                auto-detection.
+# initial value: UTF-8 
+#
+
+property_interning_dict = "http://www.python.org/sax/properties/interning-dict"
+# data type: Dictionary
+# description: The dictionary used to intern common strings in the document
+# access: write: Request that the parser uses a specific dictionary, to
+#                allow interning across different documents
+#         read:  return the current interning dictionary, or None
+#
+
 all_properties = [property_lexical_handler,
                   property_dom_node,
                   property_declaration_handler,
-                  property_xml_string]
+                  property_xml_string,
+                  property_encoding,
+                  property_interning_dict]
