From: R David Murray <rdmurray@bitdance.com>
Date: Mon, 10 Mar 2014 22:09:54 +0000 (-0400)
Subject: whatsnew: deprecation of ElementTree XMLParser *html* and iterparse *parser*.
X-Git-Tag: v3.4.1rc1~233^2~65
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=9ea2a630fe659315666769a47eccab16bc40b6e0;p=python

whatsnew: deprecation of ElementTree XMLParser *html* and iterparse *parser*.

#17741
---

diff --git a/Doc/library/xml.etree.elementtree.rst b/Doc/library/xml.etree.elementtree.rst
index dfa2b71cf5..c6dbce062a 100644
--- a/Doc/library/xml.etree.elementtree.rst
+++ b/Doc/library/xml.etree.elementtree.rst
@@ -952,7 +952,8 @@ XMLParser Objects
    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
index 9666e3926a..14a6eef832 100644
--- a/Doc/whatsnew/3.4.rst
+++ b/Doc/whatsnew/3.4.rst
@@ -2057,6 +2057,11 @@ Deprecations in the Python API
   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
 -------------------------