diff options
| author | Mark Summerfield <list@qtrac.plus.com> | 2008-03-17 08:28:15 (GMT) |
|---|---|---|
| committer | Mark Summerfield <list@qtrac.plus.com> | 2008-03-17 08:28:15 (GMT) |
| commit | 43da35de7bfbdbcba26d7d4226835cc718c2de7d (patch) | |
| tree | 7716907a8d85d4a5678119a3fc94c47d61c60aba /Doc/library/pyexpat.rst | |
| parent | 91f0ee4db6540e85f61c1a3969f62b7928d67fb8 (diff) | |
| download | cpython-43da35de7bfbdbcba26d7d4226835cc718c2de7d.zip cpython-43da35de7bfbdbcba26d7d4226835cc718c2de7d.tar.gz cpython-43da35de7bfbdbcba26d7d4226835cc718c2de7d.tar.bz2 | |
Added a footnote to each pointing out that for XML output if an encoding
string is given it should conform to the appropriate XML standards---for
example, "UTF-8" is okay, but "UTF8" is not.
Diffstat (limited to 'Doc/library/pyexpat.rst')
| -rw-r--r-- | Doc/library/pyexpat.rst | 10 |
1 files changed, 9 insertions, 1 deletions
diff --git a/Doc/library/pyexpat.rst b/Doc/library/pyexpat.rst index 9a0f914..1d5e6e6 100644 --- a/Doc/library/pyexpat.rst +++ b/Doc/library/pyexpat.rst @@ -63,7 +63,7 @@ The :mod:`xml.parsers.expat` module contains two functions: must be a string naming the encoding used by the XML data. Expat doesn't support as many encodings as Python does, and its repertoire of encodings can't be extended; it supports UTF-8, UTF-16, ISO-8859-1 (Latin1), and ASCII. If - *encoding* is given it will override the implicit or explicit encoding of the + *encoding* [1]_ is given it will override the implicit or explicit encoding of the document. Expat can optionally do XML namespace processing for you, enabled by providing a @@ -885,3 +885,11 @@ The ``errors`` object has the following attributes: .. data:: XML_ERROR_SUSPEND_PE :noindex: + +.. 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 . + |