Welcome to mirror list, hosted at ThFree Co, Russian Federation.

github.com/sphinx-doc/sphinx.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorHugo van Kemenade <hugovk@users.noreply.github.com>2022-03-24 13:34:05 +0300
committerHugo van Kemenade <hugovk@users.noreply.github.com>2022-03-24 13:34:05 +0300
commita432bf8c1022d5a4f8227c6bf309c3d2820ef9c6 (patch)
tree026275bc15b78c97cf4142877814f5c4d98f4b60
parent59e96bfbc5619f7df9929ee6a8eb3ebbdb94d523 (diff)
Update PEP links in docs
-rw-r--r--doc/tutorial/automatic-doc-generation.rst2
-rw-r--r--doc/usage/extensions/autodoc.rst2
-rw-r--r--doc/usage/extensions/doctest.rst2
-rw-r--r--doc/usage/extensions/example_google.py2
-rw-r--r--doc/usage/extensions/example_numpy.py2
-rw-r--r--doc/usage/extensions/napoleon.rst8
-rw-r--r--sphinx/ext/autodoc/__init__.py2
-rw-r--r--sphinx/ext/doctest.py2
-rw-r--r--sphinx/util/__init__.py2
9 files changed, 12 insertions, 12 deletions
diff --git a/doc/tutorial/automatic-doc-generation.rst b/doc/tutorial/automatic-doc-generation.rst
index df42c6434..6a56dbd3a 100644
--- a/doc/tutorial/automatic-doc-generation.rst
+++ b/doc/tutorial/automatic-doc-generation.rst
@@ -5,7 +5,7 @@ In the :ref:`previous section <tutorial-describing-objects>` of the tutorial
you manually documented a Python function in Sphinx. However, the description
was out of sync with the code itself, since the function signature was not
the same. Besides, it would be nice to reuse `Python
-docstrings <https://www.python.org/dev/peps/pep-0257/#what-is-a-docstring>`_
+docstrings <https://peps.python.org/pep-0257/#what-is-a-docstring>`_
in the documentation, rather than having to write the information in two
places.
diff --git a/doc/usage/extensions/autodoc.rst b/doc/usage/extensions/autodoc.rst
index 24351993d..4c3aac004 100644
--- a/doc/usage/extensions/autodoc.rst
+++ b/doc/usage/extensions/autodoc.rst
@@ -662,7 +662,7 @@ There are also config values that you can set:
...
- .. __: https://www.python.org/dev/peps/pep-0563/
+ .. __: https://peps.python.org/pep-0563/
.. __: https://mypy.readthedocs.io/en/latest/kinds_of_types.html#type-aliases
.. versionadded:: 3.3
diff --git a/doc/usage/extensions/doctest.rst b/doc/usage/extensions/doctest.rst
index 0fe9b535d..eb07def8b 100644
--- a/doc/usage/extensions/doctest.rst
+++ b/doc/usage/extensions/doctest.rst
@@ -94,7 +94,7 @@ a comma-separated list of group names.
* ``===``: Arbitrary equality clause.
``pyversion`` option is followed `PEP-440: Version Specifiers
- <https://www.python.org/dev/peps/pep-0440/#version-specifiers>`__.
+ <https://peps.python.org/pep-0440/#version-specifiers>`__.
.. versionadded:: 1.6
diff --git a/doc/usage/extensions/example_google.py b/doc/usage/extensions/example_google.py
index 5fde6e226..aacc768dc 100644
--- a/doc/usage/extensions/example_google.py
+++ b/doc/usage/extensions/example_google.py
@@ -57,7 +57,7 @@ def function_with_types_in_docstring(param1, param2):
bool: The return value. True for success, False otherwise.
.. _PEP 484:
- https://www.python.org/dev/peps/pep-0484/
+ https://peps.python.org/pep-0484/
"""
diff --git a/doc/usage/extensions/example_numpy.py b/doc/usage/extensions/example_numpy.py
index 2712447f4..f7722972e 100644
--- a/doc/usage/extensions/example_numpy.py
+++ b/doc/usage/extensions/example_numpy.py
@@ -72,7 +72,7 @@ def function_with_types_in_docstring(param1, param2):
True if successful, False otherwise.
.. _PEP 484:
- https://www.python.org/dev/peps/pep-0484/
+ https://peps.python.org/pep-0484/
"""
diff --git a/doc/usage/extensions/napoleon.rst b/doc/usage/extensions/napoleon.rst
index 68ff98acc..b18b3c466 100644
--- a/doc/usage/extensions/napoleon.rst
+++ b/doc/usage/extensions/napoleon.rst
@@ -50,7 +50,7 @@ the documentation, so it doesn't modify any of the docstrings in your actual
source code files.
.. _ReStructuredText: https://docutils.sourceforge.io/rst.html
-.. _docstrings: https://www.python.org/dev/peps/pep-0287/
+.. _docstrings: https://peps.python.org/pep-0287/
.. _Google Python Style Guide:
https://google.github.io/styleguide/pyguide.html
.. _Google:
@@ -267,9 +267,9 @@ Google style with types in docstrings::
`Python 2/3 compatible annotations`_ aren't currently
supported by Sphinx and won't show up in the docs.
-.. _PEP 484: https://www.python.org/dev/peps/pep-0484/
-.. _PEP 526: https://www.python.org/dev/peps/pep-0526/
-.. _Python 2/3 compatible annotations: https://www.python.org/dev/peps/pep-0484/#suggested-syntax-for-python-2-7-and-straddling-code
+.. _PEP 484: https://peps.python.org/pep-0484/
+.. _PEP 526: https://peps.python.org/pep-0526/
+.. _Python 2/3 compatible annotations: https://peps.python.org/pep-0484/#suggested-syntax-for-python-2-7-and-straddling-code
Configuration
diff --git a/sphinx/ext/autodoc/__init__.py b/sphinx/ext/autodoc/__init__.py
index 9bea15866..9c3c623ac 100644
--- a/sphinx/ext/autodoc/__init__.py
+++ b/sphinx/ext/autodoc/__init__.py
@@ -1661,7 +1661,7 @@ class ClassDocumenter(DocstringSignatureMixin, ModuleLevelDocumenter): # type:
if not self.doc_as_attr and self.options.show_inheritance:
if inspect.getorigbases(self.object):
# A subclass of generic types
- # refs: PEP-560 <https://www.python.org/dev/peps/pep-0560/>
+ # refs: PEP-560 <https://peps.python.org/pep-0560/>
bases = list(self.object.__orig_bases__)
elif hasattr(self.object, '__bases__') and len(self.object.__bases__):
# A normal class
diff --git a/sphinx/ext/doctest.py b/sphinx/ext/doctest.py
index 0c02547e9..0d414697c 100644
--- a/sphinx/ext/doctest.py
+++ b/sphinx/ext/doctest.py
@@ -41,7 +41,7 @@ def is_allowed_version(spec: str, version: str) -> bool:
"""Check `spec` satisfies `version` or not.
This obeys PEP-440 specifiers:
- https://www.python.org/dev/peps/pep-0440/#version-specifiers
+ https://peps.python.org/pep-0440/#version-specifiers
Some examples:
diff --git a/sphinx/util/__init__.py b/sphinx/util/__init__.py
index ee98c29c8..33e6bba28 100644
--- a/sphinx/util/__init__.py
+++ b/sphinx/util/__init__.py
@@ -422,7 +422,7 @@ def split_full_qualified_name(name: str) -> Tuple[Optional[str], str]:
"""Split full qualified name to a pair of modname and qualname.
A qualname is an abbreviation for "Qualified name" introduced at PEP-3155
- (https://www.python.org/dev/peps/pep-3155/). It is a dotted path name
+ (https://peps.python.org/pep-3155/). It is a dotted path name
from the module top-level.
A "full" qualified name means a string containing both module name and