diff --git a/pep-0606.rst b/pep-0606.rst index 0fb45ea28..d50f1b136 100644 --- a/pep-0606.rst +++ b/pep-0606.rst @@ -136,8 +136,8 @@ One of the `Zen of Python (PEP 20) When Python evolves, new ways emerge inevitably. ``DeprecationWarning`` are emitted to suggest to use the new way, but many developers ignore these warnings, which are silent by default (except in the ``__main__`` -module: see the `PEP 565 _`). -Some developers simply ignore all warnings since they are too many +module: see the `PEP 565 `_). +Some developers simply ignore all warnings when there are too many warnings, and so only bother with exceptions when deprecated code is removed. @@ -148,14 +148,14 @@ change is backward incompatible. Some developers can take the end of the Python 2 support as an opportunity to push even more incompatible changes than usual. -Adding backward compatibility as an opt-in prevents to break +Adding an opt-in backward compatibility prevents to break applications and allows developers to continue to do such cleanup. Redistribute the maintenance burden ----------------------------------- -The backward compatibility involves authors of backward incompatible +The backward compatibility involves authors of incompatible changes more in the upgrade path. @@ -205,16 +205,16 @@ compatibility is requested:: Deprecated open() "U" mode -------------------------- -The "U" mode of ``open()`` is deprecated since Python 3.4 and emits a +The ``"U"`` mode of ``open()`` is deprecated since Python 3.4 and emits a ``DeprecationWarning``. The `bpo-37330 `_ proposes to drop this mode: -``open()`` would raise an exception if ``U`` mode is used. +``open(filename, "rU")`` would raise an exception. This change falls into the "cleanup" category: it is not required to implement a feature. A backward compatibility mode would be trivial to implement and would be -welcomed here by users. +welcomed by users. Specification @@ -306,10 +306,10 @@ Alternatives Provide a workaround for each incompatible change ------------------------------------------------- -An application can works around most of the incompatible changes which +An application can work around most incompatible changes which impacts it. -For example, ``collections`` aliases can be added again using:: +For example, ``collections`` aliases can be added back using:: import collections.abc collections.Mapping = collections.abc.Mapping