summaryrefslogtreecommitdiffstats
path: root/Doc/lib/xmldomminidom.tex
diff options
context:
space:
mode:
authorFred Drake <fdrake@acm.org>2001-10-26 20:09:49 (GMT)
committerFred Drake <fdrake@acm.org>2001-10-26 20:09:49 (GMT)
commite21e2bb1219cbac16bfec768f018c103c5688321 (patch)
treeccea57957772bf154262e1e7a3f25d8451773f7f /Doc/lib/xmldomminidom.tex
parentb83769cb828e97796fecb0336f05b21ae98eacc7 (diff)
downloadcpython-e21e2bb1219cbac16bfec768f018c103c5688321.zip
cpython-e21e2bb1219cbac16bfec768f018c103c5688321.tar.gz
cpython-e21e2bb1219cbac16bfec768f018c103c5688321.tar.bz2
Fix up a number of small problems with the DOM documentation.
There's still a lot to do, but it's better now.
Diffstat (limited to 'Doc/lib/xmldomminidom.tex')
-rw-r--r--Doc/lib/xmldomminidom.tex33
1 files changed, 19 insertions, 14 deletions
diff --git a/Doc/lib/xmldomminidom.tex b/Doc/lib/xmldomminidom.tex
index 884e0c5..d743c7d 100644
--- a/Doc/lib/xmldomminidom.tex
+++ b/Doc/lib/xmldomminidom.tex
@@ -180,8 +180,10 @@ following mapping rules apply:
\item The type \code{DOMString} maps to Python strings.
\refmodule{xml.dom.minidom} supports either byte or Unicode
- strings, but will normally produce Unicode strings. Attributes
- of type \code{DOMString} may also be \code{None}.
+ strings, but will normally produce Unicode strings. Values
+ of type \code{DOMString} may also be \code{None} where allowed
+ to have the IDL \code{null} value by the DOM specification from
+ the W3C.
\item \keyword{const} declarations map to variables in their
respective scope
@@ -193,9 +195,12 @@ following mapping rules apply:
\refmodule{xml.dom.minidom} uses standard Python exceptions such
as \exception{TypeError} and \exception{AttributeError}.
-\item \class{NodeList} objects are implemented as Python's built-in
- list type, so don't support the official API, but are much more
- ``Pythonic.''
+\item \class{NodeList} objects are implemented using Python's built-in
+ list type. Starting with Python 2.2, these objects provide the
+ interface defined in the DOM specification, but with earlier
+ versions of Python they do not support the official API. They
+ are, however, much more ``Pythonic'' than the interface defined
+ in the W3C recommendations.
\end{itemize}
@@ -203,23 +208,23 @@ The following interfaces have no implementation in
\refmodule{xml.dom.minidom}:
\begin{itemize}
-\item DOMTimeStamp
+\item \class{DOMTimeStamp}
-\item DocumentType (added in Python 2.1)
+\item \class{DocumentType} (added in Python 2.1)
-\item DOMImplementation (added in Python 2.1)
+\item \class{DOMImplementation} (added in Python 2.1)
-\item CharacterData
+\item \class{CharacterData}
-\item CDATASection
+\item \class{CDATASection}
-\item Notation
+\item \class{Notation}
-\item Entity
+\item \class{Entity}
-\item EntityReference
+\item \class{EntityReference}
-\item DocumentFragment
+\item \class{DocumentFragment}
\end{itemize}
Most of these reflect information in the XML document that is not of