[Python-checkins] cpython: whatsnew: deprecation of ElementTree XMLParser *html* and iterparse *parser*.

[r.david.murray]

http://hg.python.org/cpython/rev/31e6adf5bfba
changeset:   89576:31e6adf5bfba
user:        R David Murray <rdmurray at bitdance.com>
date:        Mon Mar 10 18:09:54 2014 -0400
summary:
  whatsnew: deprecation of ElementTree XMLParser *html* and iterparse *parser*.

#17741

files:
  Doc/library/xml.etree.elementtree.rst |  3 ++-
  Doc/whatsnew/3.4.rst                  |  5 +++++
  2 files changed, 7 insertions(+), 1 deletions(-)


diff --git a/Doc/library/xml.etree.elementtree.rst b/Doc/library/xml.etree.elementtree.rst
--- a/Doc/library/xml.etree.elementtree.rst
+++ b/Doc/library/xml.etree.elementtree.rst
@@ -952,7 +952,8 @@
    specified in the XML file.
 
    .. deprecated:: 3.4
-      The *html* argument.
+      The *html* argument.  The remaining arguments should be passed via
+      keywword to prepare for the removal of the *html* argument.
 
    .. method:: close()
 
diff --git a/Doc/whatsnew/3.4.rst b/Doc/whatsnew/3.4.rst
--- a/Doc/whatsnew/3.4.rst
+++ b/Doc/whatsnew/3.4.rst
@@ -2057,6 +2057,11 @@
   appropriate uses of :class:`io.TextIOWrapper` (if needed) and its *newline*
   argument.
 
+* The *parser* argument of :func:`~xml.etree.ElementTree.iterparse` has
+  been deprecated, as has the *html* argument of
+  :func:`~xml.etree.ElementTree.XMLParser`.  To prepare for the removal of the
+  latter, all arguments to ``XMLParser`` should be passed by keyword.
+
 
 Deprecations in the C API
 -------------------------

-- 
Repository URL: http://hg.python.org/cpython