PEP 343: Resolve unreferenced footnotes (#3230)

This commit is contained in:
Adam Turner 2023-08-02 01:46:47 +01:00 committed by GitHub
parent 85986bc56a
commit 68a7773da4
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 9 additions and 22 deletions

View File

@ -30,7 +30,7 @@ on python-dev. Any first person references are from Guido's
original. original.
Python's alpha release cycle revealed terminology problems in this Python's alpha release cycle revealed terminology problems in this
PEP and in the associated documentation and implementation [14]_. PEP and in the associated documentation and implementation [13]_.
The PEP stabilised around the time of the first Python 2.5 beta The PEP stabilised around the time of the first Python 2.5 beta
release. release.
@ -558,7 +558,7 @@ of any major objections on python-dev).
3. Objects with ``__enter__/__exit__`` methods are called "context 3. Objects with ``__enter__/__exit__`` methods are called "context
managers" and the decorator to convert a generator function managers" and the decorator to convert a generator function
into a context manager factory is ``contextlib.contextmanager``. into a context manager factory is ``contextlib.contextmanager``.
There were some other suggestions [16]_ during the 2.5 release There were some other suggestions [15]_ during the 2.5 release
cycle but no compelling arguments for switching away from the cycle but no compelling arguments for switching away from the
terms that had been used in the PEP implementation were made. terms that had been used in the PEP implementation were made.
@ -569,14 +569,14 @@ Rejected Options
For several months, the PEP prohibited suppression of exceptions For several months, the PEP prohibited suppression of exceptions
in order to avoid hidden flow control. Implementation in order to avoid hidden flow control. Implementation
revealed this to be a right royal pain, so Guido restored the revealed this to be a right royal pain, so Guido restored the
ability [13]_. ability [12]_.
Another aspect of the PEP that caused no end of questions and Another aspect of the PEP that caused no end of questions and
terminology debates was providing a ``__context__()`` method that terminology debates was providing a ``__context__()`` method that
was analogous to an iterable's ``__iter__()`` method [5]_ [7]_ [9]_. was analogous to an iterable's ``__iter__()`` method [5]_ [7]_ [9]_.
The ongoing problems [10]_ [13]_ with explaining what it was and why The ongoing problems [10]_ [12]_ with explaining what it was and why
it was and how it was meant to work eventually lead to Guido it was and how it was meant to work eventually lead to Guido
killing the concept outright [15]_ (and there was much rejoicing!). killing the concept outright [14]_ (and there was much rejoicing!).
The notion of using the :pep:`342` generator API directly to define The notion of using the :pep:`342` generator API directly to define
the with statement was also briefly entertained [6]_, but quickly the with statement was also briefly entertained [6]_, but quickly
@ -953,32 +953,19 @@ References
.. [11] Guido says AttributeError is fine for missing special methods .. [11] Guido says AttributeError is fine for missing special methods
https://mail.python.org/pipermail/python-dev/2005-October/057625.html https://mail.python.org/pipermail/python-dev/2005-October/057625.html
.. [12] Original PEP 342 implementation patch .. [12] Guido restores the ability to suppress exceptions
http://sourceforge.net/tracker/index.php?func=detail&aid=1223381&group_id=5470&atid=305470
.. [13] Guido restores the ability to suppress exceptions
https://mail.python.org/pipermail/python-dev/2006-February/061909.html https://mail.python.org/pipermail/python-dev/2006-February/061909.html
.. [14] A simple question kickstarts a thorough review of PEP 343 .. [13] A simple question kickstarts a thorough review of PEP 343
https://mail.python.org/pipermail/python-dev/2006-April/063859.html https://mail.python.org/pipermail/python-dev/2006-April/063859.html
.. [15] Guido kills the __context__() method .. [14] Guido kills the __context__() method
https://mail.python.org/pipermail/python-dev/2006-April/064632.html https://mail.python.org/pipermail/python-dev/2006-April/064632.html
.. [16] Proposal to use 'context guard' instead of 'context manager' .. [15] Proposal to use 'context guard' instead of 'context manager'
https://mail.python.org/pipermail/python-dev/2006-May/064676.html https://mail.python.org/pipermail/python-dev/2006-May/064676.html
Copyright Copyright
========= =========
This document has been placed in the public domain. This document has been placed in the public domain.
..
Local Variables:
mode: indented-text
indent-tabs-mode: nil
sentence-end-double-space: t
fill-column: 70
coding: utf-8
End: