PEP 366, 395, 413, 426, 430, 440, 531, 535, 3150: Fix footnotes (#2794)

This commit is contained in:
Hugo van Kemenade 2022-09-16 08:15:18 +03:00 committed by GitHub
parent 38b778d3b9
commit 68160887c2
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
9 changed files with 67 additions and 142 deletions

View File

@ -103,7 +103,7 @@ which stored the main module's real module name in the
``__module_name__`` attribute. It was reverted due to the fact ``__module_name__`` attribute. It was reverted due to the fact
that 2.5 was already in beta by that time. that 2.5 was already in beta by that time.
Patch 1487 [4] is the proposed implementation for this PEP. Patch 1487 [4]_ is the proposed implementation for this PEP.
Alternative Proposals Alternative Proposals
===================== =====================
@ -125,7 +125,7 @@ References
========== ==========
.. [1] Absolute/relative import not working? .. [1] Absolute/relative import not working?
(https://bugs.python.org/issue1510172) (https://github.com/python/cpython/issues/43535)
.. [2] c.l.p. question about modules and relative imports .. [2] c.l.p. question about modules and relative imports
(http://groups.google.com/group/comp.lang.python/browse_thread/thread/c44c769a72ca69fa/) (http://groups.google.com/group/comp.lang.python/browse_thread/thread/c44c769a72ca69fa/)
@ -134,7 +134,7 @@ References
(https://mail.python.org/pipermail/python-3000/2007-April/006793.html) (https://mail.python.org/pipermail/python-3000/2007-April/006793.html)
.. [4] PEP 366 implementation patch .. [4] PEP 366 implementation patch
(http://bugs.python.org/issue1487) (https://github.com/python/cpython/issues/45828)
.. [5] Acceptance of the PEP .. [5] Acceptance of the PEP
(https://mail.python.org/pipermail/python-dev/2007-November/075475.html) (https://mail.python.org/pipermail/python-dev/2007-November/075475.html)
@ -143,11 +143,3 @@ 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
End:

View File

@ -715,27 +715,19 @@ None as yet.
References References
========== ==========
.. [1] Module aliases and/or "real names" .. [1] `Module aliases and/or "real names"
(https://mail.python.org/pipermail/python-ideas/2011-January/008983.html) <https://mail.python.org/pipermail/python-ideas/2011-January/008983.html>`__
.. [2] PEP 395 (Module aliasing) and the namespace PEPs .. [2] `PEP 395 (Module aliasing) and the namespace PEPs
(https://mail.python.org/pipermail/import-sig/2011-November/000382.html) <https://mail.python.org/pipermail/import-sig/2011-November/000382.html>`__
.. [3] Updated PEP 395 (aka "Implicit Relative Imports Must Die!") .. [3] `Updated PEP 395 (aka "Implicit Relative Imports Must Die!")
(https://mail.python.org/pipermail/import-sig/2011-November/000397.html) <https://mail.python.org/pipermail/import-sig/2011-November/000397.html>`__
.. [4] Elaboration of compatibility problems between this PEP and PEP 402 * `Elaboration of compatibility problems between this PEP and PEP 402
(https://mail.python.org/pipermail/import-sig/2011-November/000403.html) <https://mail.python.org/pipermail/import-sig/2011-November/000403.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
End:

View File

@ -593,7 +593,7 @@ resolving this becomes even more critical. While Mercurial phases may
help to some degree, it would be good to eliminate the problem entirely. help to some degree, it would be good to eliminate the problem entirely.
One suggestion from Barry Warsaw is to adopt a non-conflicting One suggestion from Barry Warsaw is to adopt a non-conflicting
separate-files-per-change approach, similar to that used by Twisted [2_]. separate-files-per-change approach, similar to that used by Twisted [2]_.
Given that the current manually updated NEWS file will be used for the 3.3.0 Given that the current manually updated NEWS file will be used for the 3.3.0
release, one possible layout for such an approach might look like:: release, one possible layout for such an approach might look like::
@ -914,19 +914,9 @@ References
========== ==========
.. [2] Twisted's "topfiles" approach to NEWS generation .. [2] Twisted's "topfiles" approach to NEWS generation
http://twistedmatrix.com/trac/wiki/ReviewProcess#Newsfiles https://web.archive.org/web/20120305142914/http://twistedmatrix.com/trac/wiki/ReviewProcess#Newsfiles
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:

View File

@ -443,9 +443,9 @@ in Appendix A.
Metadata validation Metadata validation
------------------- -------------------
A `jsonschema <https://pypi.python.org/pypi/jsonschema>`__ description of A `jsonschema <https://pypi.org/project/jsonschema/>`__ description of
the distribution metadata is `available the distribution metadata is `available
<http://hg.python.org/peps/file/default/pep-0426/pydist-schema.json>`__. <https://hg.python.org/peps/file/default/pep-0426/pydist-schema.json>`__.
This schema does NOT currently handle validation of some of the more complex This schema does NOT currently handle validation of some of the more complex
string fields (instead treating them as opaque strings). string fields (instead treating them as opaque strings).
@ -1507,24 +1507,15 @@ Version 1.2 is specified in :pep:`345`.
The initial attempt at a standardised version scheme, along with the The initial attempt at a standardised version scheme, along with the
justifications for needing such a standard can be found in :pep:`386`. justifications for needing such a standard can be found in :pep:`386`.
.. [1] reStructuredText markup: * `reStructuredText markup
http://docutils.sourceforge.net/ <https://docutils.sourceforge.io/>`__
.. _Python Package Index: http://pypi.python.org/pypi/ .. _Python Package Index: https://pypi.org/
.. _TR39: http://www.unicode.org/reports/tr39/tr39-1.html#Confusable_Detection .. _TR39: https://www.unicode.org/reports/tr39/tr39-1.html#Confusable_Detection
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
End:

View File

@ -28,7 +28,7 @@ Background
========== ==========
With the transition of the overall Python ecosystem from Python 2 to Python 3 With the transition of the overall Python ecosystem from Python 2 to Python 3
still in progress, one question which arises periodically [1_, 2_] is when still in progress, one question which arises periodically [1]_, [2]_ is when
and how to handle the change from providing the Python 2 documentation as and how to handle the change from providing the Python 2 documentation as
the default version displayed at the docs.python.org root URL to providing the default version displayed at the docs.python.org root URL to providing
the Python 3 documentation. the Python 3 documentation.
@ -77,7 +77,7 @@ the path component.
Proposal Proposal
======== ========
This PEP (based on an idea originally put forward back in May [3_]) is to This PEP (based on an idea originally put forward back in May [3]_) is to
*not migrate* the Python 2 specific deep links at all, and instead adopt a *not migrate* the Python 2 specific deep links at all, and instead adopt a
scheme where all URLs presented to users on docs.python.org are qualified scheme where all URLs presented to users on docs.python.org are qualified
appropriately with the relevant release series. appropriately with the relevant release series.

View File

@ -39,7 +39,7 @@ document are to be interpreted as described in :rfc:`2119`.
Projects include Python libraries, frameworks, scripts, plugins, Projects include Python libraries, frameworks, scripts, plugins,
applications, collections of data or other resources, and various applications, collections of data or other resources, and various
combinations thereof. Public Python projects are typically registered on combinations thereof. Public Python projects are typically registered on
the `Python Package Index <https://pypi.python.org>`__. the `Python Package Index <https://pypi.org/>`__.
"Releases" are uniquely identified snapshots of a project. "Releases" are uniquely identified snapshots of a project.
@ -762,7 +762,7 @@ specify the appropriate version order.
Specific build information may also be included in local version labels. Specific build information may also be included in local version labels.
.. _Semantic versioning: http://semver.org/ .. _Semantic versioning: https://semver.org/
DVCS based version labels DVCS based version labels
@ -1556,35 +1556,35 @@ References
The initial attempt at a standardised version scheme, along with the The initial attempt at a standardised version scheme, along with the
justifications for needing such a standard can be found in :pep:`386`. justifications for needing such a standard can be found in :pep:`386`.
.. [1] Reference Implementation of PEP 440 Versions and Specifiers .. [2] `Version compatibility analysis script
https://github.com/pypa/packaging/pull/1 <https://github.com/pypa/packaging/blob/master/tasks/check.py>`__
.. [2] Version compatibility analysis script: .. [4] `File URIs in Windows
https://github.com/pypa/packaging/blob/master/tasks/check.py <https://web.archive.org/web/20130321051043/http://blogs.msdn.com/b/ie/archive/2006/12/06/file-uris-in-windows.aspx>`__
.. [3] Pessimistic version constraint .. [5] `Proof of Concept: PEP 440 within pip
http://docs.rubygems.org/read/chapter/16 <https://github.com/pypa/pip/pull/1894>`__
.. [4] File URIs in Windows .. [6] `PEP440: foo-X.Y.Z does not satisfy "foo>X.Y"
http://blogs.msdn.com/b/ie/archive/2006/12/06/file-uris-in-windows.aspx <https://mail.python.org/pipermail/distutils-sig/2014-December/025451.html>`__
.. [5] Proof of Concept: PEP 440 within pip .. [7] `PEP440: >1.7 vs >=1.7
https://github.com/pypa/pip/pull/1894 <https://mail.python.org/pipermail/distutils-sig/2014-December/025507.html>`__
.. [6] PEP440: foo-X.Y.Z does not satisfy "foo>X.Y" .. [8] `Amend PEP 440 with Wider Feedback on Release Candidates
https://mail.python.org/pipermail/distutils-sig/2014-December/025451.html <https://mail.python.org/pipermail/distutils-sig/2014-December/025409.html>`__
.. [7] PEP440: >1.7 vs >=1.7 .. [10] `PEP 440: regex should not permit Unicode [Nd] characters
https://mail.python.org/pipermail/distutils-sig/2014-December/025507.html <https://github.com/python/peps/pull/966>`__
.. [8] Amend PEP 440 with Wider Feedback on Release Candidates * `Reference Implementation of PEP 440 Versions and Specifiers
https://mail.python.org/pipermail/distutils-sig/2014-December/025409.html <https://github.com/pypa/packaging/pull/1>`__
.. [9] Changing the status of PEP 440 to Provisional * `Pessimistic version constraint
https://mail.python.org/pipermail/distutils-sig/2014-December/025412.html <https://web.archive.org/web/20130509214125/http://docs.rubygems.org/read/chapter/16>`__
.. [10] PEP 440: regex should not permit Unicode [Nd] characters * `Changing the status of PEP 440 to Provisional
https://github.com/python/peps/pull/966 <https://mail.python.org/pipermail/distutils-sig/2014-December/025412.html>`__
Appendix A Appendix A
========== ==========
@ -1659,12 +1659,3 @@ 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
End:

View File

@ -55,7 +55,7 @@ following characteristics:
PEP Withdrawal PEP Withdrawal
============== ==============
When posting this PEP for discussion on python-ideas [4_], I asked reviewers to When posting this PEP for discussion on python-ideas [4]_, I asked reviewers to
consider 3 high level design questions before moving on to considering the consider 3 high level design questions before moving on to considering the
specifics of this particular syntactic proposal: specifics of this particular syntactic proposal:
@ -74,7 +74,7 @@ truth-checking "and" and "or" control flow operators were available?
While the answers to the first question were generally positive, it quickly While the answers to the first question were generally positive, it quickly
became clear that the answer to the second question is "No". became clear that the answer to the second question is "No".
Steven D'Aprano articulated the counter-argument well in [5_], but the general Steven D'Aprano articulated the counter-argument well in [5]_, but the general
idea is that when checking for "missing data" sentinels, we're almost always idea is that when checking for "missing data" sentinels, we're almost always
looking for a *specific* sentinel value, rather than *any* sentinel value. looking for a *specific* sentinel value, rather than *any* sentinel value.
@ -96,7 +96,7 @@ make sense, and it is accordingly withdrawn.
However, the discussion of the proposal did prompt consideration of a potential However, the discussion of the proposal did prompt consideration of a potential
protocol based approach to make the existing ``and``, ``or`` and ``if-else`` protocol based approach to make the existing ``and``, ``or`` and ``if-else``
operators more flexible [6_] without introducing any new syntax, so I'll be operators more flexible [6]_ without introducing any new syntax, so I'll be
writing that up as another possible alternative to :pep:`505`. writing that up as another possible alternative to :pep:`505`.
@ -645,13 +645,3 @@ Copyright
This document has been placed in the public domain under the terms of the This document has been placed in the public domain under the terms of the
CC0 1.0 license: https://creativecommons.org/publicdomain/zero/1.0/ CC0 1.0 license: https://creativecommons.org/publicdomain/zero/1.0/
..
Local Variables:
mode: indented-text
indent-tabs-mode: nil
sentence-end-double-space: t
fill-column: 70
coding: utf-8
End:

View File

@ -81,7 +81,7 @@ operations would be the same as the existing expansion for ``and``.
Rationale Rationale
========= =========
In ultimately rejecting :pep:`335`, Guido van Rossum noted [1_]: In ultimately rejecting :pep:`335`, Guido van Rossum noted [1]_:
The NumPy folks brought up a somewhat separate issue: for them, The NumPy folks brought up a somewhat separate issue: for them,
the most common use case is chained comparisons (e.g. A < B < C). the most common use case is chained comparisons (e.g. A < B < C).
@ -187,13 +187,3 @@ Copyright
This document has been placed in the public domain under the terms of the This document has been placed in the public domain under the terms of the
CC0 1.0 license: https://creativecommons.org/publicdomain/zero/1.0/ CC0 1.0 license: https://creativecommons.org/publicdomain/zero/1.0/
..
Local Variables:
mode: indented-text
indent-tabs-mode: nil
sentence-end-double-space: t
fill-column: 70
coding: utf-8
End:

View File

@ -738,48 +738,37 @@ TO-DO
References References
========== ==========
.. [1] Explicitation lines in Python: .. [1] `Explicitation lines in Python
https://mail.python.org/pipermail/python-ideas/2010-June/007476.html <https://mail.python.org/pipermail/python-ideas/2010-June/007476.html>`__
.. [2] 'where' statement in Python: .. [2] `'where' statement in Python
https://mail.python.org/pipermail/python-ideas/2010-July/007584.html <https://mail.python.org/pipermail/python-ideas/2010-July/007584.html>`__
.. [3] Where-statement (Proposal for function expressions): .. [3] `Where-statement (Proposal for function expressions)
https://mail.python.org/pipermail/python-ideas/2009-July/005132.html <https://mail.python.org/pipermail/python-ideas/2009-July/005132.html>`__
.. [4] Name conflict with NumPy for 'where' keyword choice: .. [4] `Name conflict with NumPy for 'where' keyword choice
https://mail.python.org/pipermail/python-ideas/2010-July/007596.html <https://mail.python.org/pipermail/python-ideas/2010-July/007596.html>`__
.. [5] The "Status quo wins a stalemate" design principle: .. [6] `Assignments in list/generator expressions
http://www.boredomandlaziness.org/2011/02/status-quo-wins-stalemate.html <https://mail.python.org/pipermail/python-ideas/2011-April/009863.html>`__
.. [6] Assignments in list/generator expressions: .. [7] `Possible PEP 3150 style guidelines (#1)
https://mail.python.org/pipermail/python-ideas/2011-April/009863.html <https://mail.python.org/pipermail/python-ideas/2011-April/009869.html>`__
.. [7] Possible PEP 3150 style guidelines (#1): .. [8] `Discussion of PEP 403 (statement local function definition)
https://mail.python.org/pipermail/python-ideas/2011-April/009869.html <https://mail.python.org/pipermail/python-ideas/2011-October/012276.html>`__
.. [8] Discussion of PEP 403 (statement local function definition): .. [9] `Possible PEP 3150 style guidelines (#2)
https://mail.python.org/pipermail/python-ideas/2011-October/012276.html <https://mail.python.org/pipermail/python-ideas/2011-October/012341.html>`__
.. [9] Possible PEP 3150 style guidelines (#2): * `The "Status quo wins a stalemate" design principle
https://mail.python.org/pipermail/python-ideas/2011-October/012341.html <https://www.curiousefficiency.org/posts/2011/02/status-quo-wins-stalemate.html>`__
.. [10] Multi-line lambdas (again!) * `Multi-line lambdas (again!)
https://mail.python.org/pipermail/python-ideas/2013-August/022526.html <https://mail.python.org/pipermail/python-ideas/2013-August/022526.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: