pep-0492: Reword DocumentLS.async deprecation section

This commit is contained in:
Yury Selivanov 2015-05-01 02:35:06 -04:00
parent 6d2ded2b90
commit 384743cdef
1 changed files with 6 additions and 5 deletions

View File

@ -852,11 +852,12 @@ renaming ``async()`` function to ``ensure_future()`` (see `asyncio`_
section for details.)
Another use of ``async`` keyword is in ``Lib/xml/dom/xmlbuilder.py``,
class ``DocumentLS``. ``async`` property is not documented, not
tested, and is not used anywhere. Methods that were likely supposed to
work with it -- ``_set_async()`` and ``_get_async()`` -- are not used
anywhere either. These methods will be deprecated in 3.5 and removed
in 3.6.
to define an ``async = False`` attribute for ``DocumentLS`` class.
There is no documentation or tests for it, it is not used anywhere else
in CPython. It is replaced with a getter, that raises a
``DeprecationWarning``, advising to use ``async_`` attribute instead.
'async' attribute is not documented and is not used in CPython code
base.
Grammar Updates