diff options
Diffstat (limited to 'Doc/library/xml.dom.minidom.rst')
| -rw-r--r-- | Doc/library/xml.dom.minidom.rst | 14 |
1 files changed, 10 insertions, 4 deletions
diff --git a/Doc/library/xml.dom.minidom.rst b/Doc/library/xml.dom.minidom.rst index 75f381e..de67d07 100644 --- a/Doc/library/xml.dom.minidom.rst +++ b/Doc/library/xml.dom.minidom.rst @@ -147,10 +147,10 @@ module documentation. This section lists the differences between the API and document. Encoding this string in an encoding other than UTF-8 is likely incorrect, since UTF-8 is the default encoding of XML. - With an explicit *encoding* argument, the result is a :class:`bytes` object - in the specified encoding. It is recommended that this argument is always - specified. To avoid :exc:`UnicodeError` exceptions in case of unrepresentable - text data, the encoding argument should be specified as "utf-8". + With an explicit *encoding* [1]_ argument, the result is a byte string in the + specified encoding. It is recommended that this argument is always specified. To + avoid :exc:`UnicodeError` exceptions in case of unrepresentable text data, the + encoding argument should be specified as "utf-8". .. method:: Node.toprettyxml([indent[, newl[, encoding]]]) @@ -252,3 +252,9 @@ The following interfaces have no implementation in :mod:`xml.dom.minidom`: Most of these reflect information in the XML document that is not of general utility to most DOM users. +.. rubric:: Footnotes + +.. [#] The encoding string included in XML output should conform to the + appropriate standards. For example, "UTF-8" is valid, but "UTF8" is + not. See http://www.w3.org/TR/2006/REC-xml11-20060816/#NT-EncodingDecl + and http://www.iana.org/assignments/character-sets . |