mirror of https://github.com/python/cpython
bpo-47126: Update to canonical PEP URLs specified by PEP 676 (GH-32124)
This commit is contained in:
parent
d8f530fe32
commit
6881ea936e
|
@ -58,7 +58,7 @@ bound into a function.
|
||||||
If you just need the line number of a frame, use :c:func:`PyFrame_GetLineNumber` instead.
|
If you just need the line number of a frame, use :c:func:`PyFrame_GetLineNumber` instead.
|
||||||
|
|
||||||
For efficiently iterating over the line numbers in a code object, use `the API described in PEP 626
|
For efficiently iterating over the line numbers in a code object, use `the API described in PEP 626
|
||||||
<https://www.python.org/dev/peps/pep-0626/#out-of-process-debuggers-and-profilers>`_.
|
<https://peps.python.org/pep-0626/#out-of-process-debuggers-and-profilers>`_.
|
||||||
|
|
||||||
.. c:function:: int PyCode_Addr2Location(PyObject *co, int byte_offset, int *start_line, int *start_column, int *end_line, int *end_column)
|
.. c:function:: int PyCode_Addr2Location(PyObject *co, int byte_offset, int *start_line, int *start_column, int *end_line, int *end_column)
|
||||||
|
|
||||||
|
|
|
@ -218,9 +218,7 @@ coverage_ignore_c_items = {
|
||||||
# ----------------------------
|
# ----------------------------
|
||||||
|
|
||||||
# Ignore certain URLs.
|
# Ignore certain URLs.
|
||||||
linkcheck_ignore = [r'https://bugs.python.org/(issue)?\d+',
|
linkcheck_ignore = [r'https://bugs.python.org/(issue)?\d+']
|
||||||
# Ignore PEPs for now, they all have permanent redirects.
|
|
||||||
r'http://www.python.org/dev/peps/pep-\d+']
|
|
||||||
|
|
||||||
|
|
||||||
# Options for extensions
|
# Options for extensions
|
||||||
|
|
|
@ -62,7 +62,7 @@ Notes:
|
||||||
requires the :program:`compress` program. Notice that this format is now
|
requires the :program:`compress` program. Notice that this format is now
|
||||||
pending for deprecation and will be removed in the future versions of Python.
|
pending for deprecation and will be removed in the future versions of Python.
|
||||||
(5)
|
(5)
|
||||||
deprecated by `PEP 527 <https://www.python.org/dev/peps/pep-0527/>`_;
|
deprecated by `PEP 527 <https://peps.python.org/pep-0527/>`_;
|
||||||
`PyPI <https://pypi.org>`_ only accepts ``.zip`` and ``.tar.gz`` files.
|
`PyPI <https://pypi.org>`_ only accepts ``.zip`` and ``.tar.gz`` files.
|
||||||
|
|
||||||
When using any ``tar`` format (``gztar``, ``bztar``, ``xztar``, ``ztar`` or
|
When using any ``tar`` format (``gztar``, ``bztar``, ``xztar``, ``ztar`` or
|
||||||
|
|
|
@ -310,7 +310,7 @@ The latest stable releases can always be found on the `Python download page
|
||||||
<https://www.python.org/downloads/>`_. There are two production-ready versions
|
<https://www.python.org/downloads/>`_. There are two production-ready versions
|
||||||
of Python: 2.x and 3.x. The recommended version is 3.x, which is supported by
|
of Python: 2.x and 3.x. The recommended version is 3.x, which is supported by
|
||||||
most widely used libraries. Although 2.x is still widely used, `it is not
|
most widely used libraries. Although 2.x is still widely used, `it is not
|
||||||
maintained anymore <https://www.python.org/dev/peps/pep-0373/>`_.
|
maintained anymore <https://peps.python.org/pep-0373/>`_.
|
||||||
|
|
||||||
How many people are using Python?
|
How many people are using Python?
|
||||||
---------------------------------
|
---------------------------------
|
||||||
|
@ -345,7 +345,7 @@ include Google, Yahoo, and Lucasfilm Ltd.
|
||||||
What new developments are expected for Python in the future?
|
What new developments are expected for Python in the future?
|
||||||
------------------------------------------------------------
|
------------------------------------------------------------
|
||||||
|
|
||||||
See https://www.python.org/dev/peps/ for the Python Enhancement Proposals
|
See https://peps.python.org/ for the Python Enhancement Proposals
|
||||||
(PEPs). PEPs are design documents describing a suggested new feature for Python,
|
(PEPs). PEPs are design documents describing a suggested new feature for Python,
|
||||||
providing a concise technical specification and a rationale. Look for a PEP
|
providing a concise technical specification and a rationale. Look for a PEP
|
||||||
titled "Python X.Y Release Schedule", where X.Y is a version that hasn't been
|
titled "Python X.Y Release Schedule", where X.Y is a version that hasn't been
|
||||||
|
|
|
@ -1826,7 +1826,7 @@ Function and class definitions
|
||||||
* ``bases`` is a list of nodes for explicitly specified base classes.
|
* ``bases`` is a list of nodes for explicitly specified base classes.
|
||||||
* ``keywords`` is a list of :class:`keyword` nodes, principally for 'metaclass'.
|
* ``keywords`` is a list of :class:`keyword` nodes, principally for 'metaclass'.
|
||||||
Other keywords will be passed to the metaclass, as per `PEP-3115
|
Other keywords will be passed to the metaclass, as per `PEP-3115
|
||||||
<https://www.python.org/dev/peps/pep-3115/>`_.
|
<https://peps.python.org/pep-3115/>`_.
|
||||||
* ``starargs`` and ``kwargs`` are each a single node, as in a function call.
|
* ``starargs`` and ``kwargs`` are each a single node, as in a function call.
|
||||||
starargs will be expanded to join the list of base classes, and kwargs will
|
starargs will be expanded to join the list of base classes, and kwargs will
|
||||||
be passed to the metaclass.
|
be passed to the metaclass.
|
||||||
|
|
|
@ -208,7 +208,7 @@ The :mod:`functools` module defines the following functions:
|
||||||
@lru_cache(maxsize=32)
|
@lru_cache(maxsize=32)
|
||||||
def get_pep(num):
|
def get_pep(num):
|
||||||
'Retrieve text of a Python Enhancement Proposal'
|
'Retrieve text of a Python Enhancement Proposal'
|
||||||
resource = 'https://www.python.org/dev/peps/pep-%04d/' % num
|
resource = 'https://peps.python.org/pep-%04d/' % num
|
||||||
try:
|
try:
|
||||||
with urllib.request.urlopen(resource) as s:
|
with urllib.request.urlopen(resource) as s:
|
||||||
return s.read()
|
return s.read()
|
||||||
|
|
|
@ -191,7 +191,7 @@ Module functions and constants
|
||||||
| | | | connections and cursors |
|
| | | | connections and cursors |
|
||||||
+------------------+-----------------+----------------------+-------------------------------+
|
+------------------+-----------------+----------------------+-------------------------------+
|
||||||
|
|
||||||
.. _threadsafety: https://www.python.org/dev/peps/pep-0249/#threadsafety
|
.. _threadsafety: https://peps.python.org/pep-0249/#threadsafety
|
||||||
.. _SQLITE_THREADSAFE: https://sqlite.org/compile.html#threadsafe
|
.. _SQLITE_THREADSAFE: https://sqlite.org/compile.html#threadsafe
|
||||||
|
|
||||||
.. versionchanged:: 3.11
|
.. versionchanged:: 3.11
|
||||||
|
|
|
@ -3,7 +3,7 @@
|
||||||
# Sphinx version is pinned so that new versions that introduce new warnings
|
# Sphinx version is pinned so that new versions that introduce new warnings
|
||||||
# won't suddenly cause build failures. Updating the version is fine as long
|
# won't suddenly cause build failures. Updating the version is fine as long
|
||||||
# as no warnings are raised by doing so.
|
# as no warnings are raised by doing so.
|
||||||
sphinx==4.2.0
|
sphinx==4.5.0
|
||||||
|
|
||||||
blurb
|
blurb
|
||||||
|
|
||||||
|
|
|
@ -10,7 +10,7 @@
|
||||||
<h3>{% trans %}Other resources{% endtrans %}</h3>
|
<h3>{% trans %}Other resources{% endtrans %}</h3>
|
||||||
<ul>
|
<ul>
|
||||||
{# XXX: many of these should probably be merged in the main docs #}
|
{# XXX: many of these should probably be merged in the main docs #}
|
||||||
<li><a href="https://www.python.org/dev/peps/">{% trans %}PEP Index{% endtrans %}</a></li>
|
<li><a href="https://peps.python.org/">{% trans %}PEP Index{% endtrans %}</a></li>
|
||||||
<li><a href="https://wiki.python.org/moin/BeginnersGuide">{% trans %}Beginner's Guide{% endtrans %}</a></li>
|
<li><a href="https://wiki.python.org/moin/BeginnersGuide">{% trans %}Beginner's Guide{% endtrans %}</a></li>
|
||||||
<li><a href="https://wiki.python.org/moin/PythonBooks">{% trans %}Book List{% endtrans %}</a></li>
|
<li><a href="https://wiki.python.org/moin/PythonBooks">{% trans %}Book List{% endtrans %}</a></li>
|
||||||
<li><a href="https://www.python.org/doc/av/">{% trans %}Audio/Visual Talks{% endtrans %}</a></li>
|
<li><a href="https://www.python.org/doc/av/">{% trans %}Audio/Visual Talks{% endtrans %}</a></li>
|
||||||
|
|
|
@ -130,7 +130,7 @@ Guidelines":
|
||||||
Read the rest of :pep:`1` for the details of the PEP editorial process, style, and
|
Read the rest of :pep:`1` for the details of the PEP editorial process, style, and
|
||||||
format. PEPs are kept in the Python CVS tree on SourceForge, though they're not
|
format. PEPs are kept in the Python CVS tree on SourceForge, though they're not
|
||||||
part of the Python 2.0 distribution, and are also available in HTML form from
|
part of the Python 2.0 distribution, and are also available in HTML form from
|
||||||
https://www.python.org/dev/peps/. As of September 2000, there are 25 PEPS, ranging
|
https://peps.python.org/. As of September 2000, there are 25 PEPS, ranging
|
||||||
from :pep:`201`, "Lockstep Iteration", to PEP 225, "Elementwise/Objectwise
|
from :pep:`201`, "Lockstep Iteration", to PEP 225, "Elementwise/Objectwise
|
||||||
Operators".
|
Operators".
|
||||||
|
|
||||||
|
|
|
@ -2681,7 +2681,7 @@ these commands by default, as long as, when invoked, they provide clear and
|
||||||
simple directions on how to install them on that platform (usually using
|
simple directions on how to install them on that platform (usually using
|
||||||
the system package manager).
|
the system package manager).
|
||||||
|
|
||||||
__ https://www.python.org/dev/peps/pep-0477/#disabling-ensurepip-by-downstream-distributors
|
__ https://peps.python.org/pep-0477/#disabling-ensurepip-by-downstream-distributors
|
||||||
|
|
||||||
|
|
||||||
Documentation Changes
|
Documentation Changes
|
||||||
|
|
|
@ -220,7 +220,7 @@ these commands by default, as long as, when invoked, they provide clear and
|
||||||
simple directions on how to install them on that platform (usually using
|
simple directions on how to install them on that platform (usually using
|
||||||
the system package manager).
|
the system package manager).
|
||||||
|
|
||||||
__ https://www.python.org/dev/peps/pep-0453/#recommendations-for-downstream-distributors
|
__ https://peps.python.org/pep-0453/#recommendations-for-downstream-distributors
|
||||||
|
|
||||||
.. note::
|
.. note::
|
||||||
|
|
||||||
|
|
|
@ -353,7 +353,7 @@ module:
|
||||||
|
|
||||||
The new functions return the number of nanoseconds as an integer value.
|
The new functions return the number of nanoseconds as an integer value.
|
||||||
|
|
||||||
`Measurements <https://www.python.org/dev/peps/pep-0564/#annex-clocks-resolution-in-python>`_
|
`Measurements <https://peps.python.org/pep-0564/#annex-clocks-resolution-in-python>`_
|
||||||
show that on Linux and Windows the resolution of :func:`time.time_ns` is
|
show that on Linux and Windows the resolution of :func:`time.time_ns` is
|
||||||
approximately 3 times better than that of :func:`time.time`.
|
approximately 3 times better than that of :func:`time.time`.
|
||||||
|
|
||||||
|
|
|
@ -298,7 +298,7 @@ class Field:
|
||||||
# This is used to support the PEP 487 __set_name__ protocol in the
|
# This is used to support the PEP 487 __set_name__ protocol in the
|
||||||
# case where we're using a field that contains a descriptor as a
|
# case where we're using a field that contains a descriptor as a
|
||||||
# default value. For details on __set_name__, see
|
# default value. For details on __set_name__, see
|
||||||
# https://www.python.org/dev/peps/pep-0487/#implementation-details.
|
# https://peps.python.org/pep-0487/#implementation-details.
|
||||||
#
|
#
|
||||||
# Note that in _process_class, this Field object is overwritten
|
# Note that in _process_class, this Field object is overwritten
|
||||||
# with the default value, so the end result is a descriptor that
|
# with the default value, so the end result is a descriptor that
|
||||||
|
|
|
@ -692,7 +692,7 @@ class build_ext(Command):
|
||||||
suffix = '_' + ext.name.split('.')[-1]
|
suffix = '_' + ext.name.split('.')[-1]
|
||||||
try:
|
try:
|
||||||
# Unicode module name support as defined in PEP-489
|
# Unicode module name support as defined in PEP-489
|
||||||
# https://www.python.org/dev/peps/pep-0489/#export-hook-name
|
# https://peps.python.org/pep-0489/#export-hook-name
|
||||||
suffix.encode('ascii')
|
suffix.encode('ascii')
|
||||||
except UnicodeEncodeError:
|
except UnicodeEncodeError:
|
||||||
suffix = 'U' + suffix.encode('punycode').replace(b'-', b'_').decode('ascii')
|
suffix = 'U' + suffix.encode('punycode').replace(b'-', b'_').decode('ascii')
|
||||||
|
|
|
@ -701,10 +701,10 @@ class HTMLDoc(Doc):
|
||||||
url = escape(all).replace('"', '"')
|
url = escape(all).replace('"', '"')
|
||||||
results.append('<a href="%s">%s</a>' % (url, url))
|
results.append('<a href="%s">%s</a>' % (url, url))
|
||||||
elif rfc:
|
elif rfc:
|
||||||
url = 'http://www.rfc-editor.org/rfc/rfc%d.txt' % int(rfc)
|
url = 'https://www.rfc-editor.org/rfc/rfc%d.txt' % int(rfc)
|
||||||
results.append('<a href="%s">%s</a>' % (url, escape(all)))
|
results.append('<a href="%s">%s</a>' % (url, escape(all)))
|
||||||
elif pep:
|
elif pep:
|
||||||
url = 'https://www.python.org/dev/peps/pep-%04d/' % int(pep)
|
url = 'https://peps.python.org/pep-%04d/' % int(pep)
|
||||||
results.append('<a href="%s">%s</a>' % (url, escape(all)))
|
results.append('<a href="%s">%s</a>' % (url, escape(all)))
|
||||||
elif selfdot:
|
elif selfdot:
|
||||||
# Create a link for methods like 'self.method(...)'
|
# Create a link for methods like 'self.method(...)'
|
||||||
|
|
|
@ -2,7 +2,7 @@
|
||||||
managing secrets such as account authentication, tokens, and similar.
|
managing secrets such as account authentication, tokens, and similar.
|
||||||
|
|
||||||
See PEP 506 for more information.
|
See PEP 506 for more information.
|
||||||
https://www.python.org/dev/peps/pep-0506/
|
https://peps.python.org/pep-0506/
|
||||||
|
|
||||||
"""
|
"""
|
||||||
|
|
||||||
|
|
|
@ -146,9 +146,9 @@ class DocXMLRPCHTTPGETServer(unittest.TestCase):
|
||||||
self.assertIn(
|
self.assertIn(
|
||||||
(b'<dl><dt><a name="-add"><strong>add</strong></a>(x, y)</dt><dd>'
|
(b'<dl><dt><a name="-add"><strong>add</strong></a>(x, y)</dt><dd>'
|
||||||
b'<tt>Add two instances together. This '
|
b'<tt>Add two instances together. This '
|
||||||
b'follows <a href="https://www.python.org/dev/peps/pep-0008/">'
|
b'follows <a href="https://peps.python.org/pep-0008/">'
|
||||||
b'PEP008</a>, but has nothing<br>\nto do '
|
b'PEP008</a>, but has nothing<br>\nto do '
|
||||||
b'with <a href="http://www.rfc-editor.org/rfc/rfc1952.txt">'
|
b'with <a href="https://www.rfc-editor.org/rfc/rfc1952.txt">'
|
||||||
b'RFC1952</a>. Case should matter: pEp008 '
|
b'RFC1952</a>. Case should matter: pEp008 '
|
||||||
b'and rFC1952. Things<br>\nthat start '
|
b'and rFC1952. Things<br>\nthat start '
|
||||||
b'with http and ftp should be '
|
b'with http and ftp should be '
|
||||||
|
|
|
@ -2,7 +2,7 @@
|
||||||
|
|
||||||
This module is an implementation of PEP 205:
|
This module is an implementation of PEP 205:
|
||||||
|
|
||||||
https://www.python.org/dev/peps/pep-0205/
|
https://peps.python.org/pep-0205/
|
||||||
"""
|
"""
|
||||||
|
|
||||||
# Naming convention: Variables named "wr" are weak reference objects;
|
# Naming convention: Variables named "wr" are weak reference objects;
|
||||||
|
|
|
@ -731,10 +731,10 @@ class ServerHTMLDoc(pydoc.HTMLDoc):
|
||||||
url = escape(all).replace('"', '"')
|
url = escape(all).replace('"', '"')
|
||||||
results.append('<a href="%s">%s</a>' % (url, url))
|
results.append('<a href="%s">%s</a>' % (url, url))
|
||||||
elif rfc:
|
elif rfc:
|
||||||
url = 'http://www.rfc-editor.org/rfc/rfc%d.txt' % int(rfc)
|
url = 'https://www.rfc-editor.org/rfc/rfc%d.txt' % int(rfc)
|
||||||
results.append('<a href="%s">%s</a>' % (url, escape(all)))
|
results.append('<a href="%s">%s</a>' % (url, escape(all)))
|
||||||
elif pep:
|
elif pep:
|
||||||
url = 'https://www.python.org/dev/peps/pep-%04d/' % int(pep)
|
url = 'https://peps.python.org/pep-%04d/' % int(pep)
|
||||||
results.append('<a href="%s">%s</a>' % (url, escape(all)))
|
results.append('<a href="%s">%s</a>' % (url, escape(all)))
|
||||||
elif text[end:end+1] == '(':
|
elif text[end:end+1] == '(':
|
||||||
results.append(self.namelink(name, methods, funcs, classes))
|
results.append(self.namelink(name, methods, funcs, classes))
|
||||||
|
|
|
@ -0,0 +1 @@
|
||||||
|
Update PEP URLs to :pep:`676`'s new canonical form.
|
|
@ -523,7 +523,7 @@ ensure_utf8(char *line, struct tok_state *tok)
|
||||||
"Non-UTF-8 code starting with '\\x%.2x' "
|
"Non-UTF-8 code starting with '\\x%.2x' "
|
||||||
"in file %U on line %i, "
|
"in file %U on line %i, "
|
||||||
"but no encoding declared; "
|
"but no encoding declared; "
|
||||||
"see https://python.org/dev/peps/pep-0263/ for details",
|
"see https://peps.python.org/pep-0263/ for details",
|
||||||
badchar, tok->filename, tok->lineno + 1);
|
badchar, tok->filename, tok->lineno + 1);
|
||||||
return 0;
|
return 0;
|
||||||
}
|
}
|
||||||
|
|
|
@ -228,7 +228,7 @@ If you have a proposal to change Python, you may want to send an email to the
|
||||||
`comp.lang.python`_ or `python-ideas`_ mailing lists for initial feedback. A
|
`comp.lang.python`_ or `python-ideas`_ mailing lists for initial feedback. A
|
||||||
Python Enhancement Proposal (PEP) may be submitted if your idea gains ground.
|
Python Enhancement Proposal (PEP) may be submitted if your idea gains ground.
|
||||||
All current PEPs, as well as guidelines for submitting a new PEP, are listed at
|
All current PEPs, as well as guidelines for submitting a new PEP, are listed at
|
||||||
`python.org/dev/peps/ <https://www.python.org/dev/peps/>`_.
|
`peps.python.org <https://peps.python.org/>`_.
|
||||||
|
|
||||||
.. _python-ideas: https://mail.python.org/mailman/listinfo/python-ideas/
|
.. _python-ideas: https://mail.python.org/mailman/listinfo/python-ideas/
|
||||||
.. _comp.lang.python: https://mail.python.org/mailman/listinfo/python-list
|
.. _comp.lang.python: https://mail.python.org/mailman/listinfo/python-list
|
||||||
|
|
|
@ -656,7 +656,7 @@ def main():
|
||||||
|
|
||||||
And in PEP 384:
|
And in PEP 384:
|
||||||
|
|
||||||
https://www.python.org/dev/peps/pep-0384/
|
https://peps.python.org/pep-0384/
|
||||||
""")
|
""")
|
||||||
|
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue