bpo-35042: Use the :pep: role where a PEP is specified (#10036)

28 files changed, 61 insertions, 60 deletions

diff --git a/Misc/NEWS.d/3.5.0a1.rst b/Misc/NEWS.d/3.5.0a1.rst
index 7eb8326..31ec21f 100644
--- a/Misc/NEWS.d/3.5.0a1.rst
+++ b/Misc/NEWS.d/3.5.0a1.rst
@@ -3555,7 +3555,7 @@ created for every test class.
 .. nonce: kfV0wm
 .. section: Library
 
-Fix PEP 3118 format strings on ctypes objects with a nontrivial shape.
+Fix :pep:`3118` format strings on ctypes objects with a nontrivial shape.
 
 ..
 
@@ -4824,7 +4824,7 @@ tests.
 .. nonce: kqetng
 .. section: IDLE
 
-Change default paragraph width to 72, the PEP 8 recommendation.
+Change default paragraph width to 72, the :pep:`8` recommendation.
 
 ..
 
@@ -5759,7 +5759,7 @@ Add support for ``yield from`` to 2to3.
 .. nonce: dpFbyZ
 .. section: Tools/Demos
 
-Add support for the PEP 465 matrix multiplication operator to 2to3.
+Add support for the :pep:`465` matrix multiplication operator to 2to3.
 
 ..
 
diff --git a/Misc/NEWS.d/3.5.0a2.rst b/Misc/NEWS.d/3.5.0a2.rst
index b16acdb..861b23e 100644
--- a/Misc/NEWS.d/3.5.0a2.rst
+++ b/Misc/NEWS.d/3.5.0a2.rst
@@ -15,7 +15,7 @@ previous exception.
 .. nonce: Ks6_2x
 .. section: Library
 
-New os.scandir() function, part of the PEP 471: "os.scandir() function -- a
+New os.scandir() function, part of the :pep:`471`: "os.scandir() function -- a
 better and faster directory iterator". Patch written by Ben Hoyt.
 
 ..
@@ -393,7 +393,7 @@ attribute.
 .. nonce: qBauCy
 .. section: Windows
 
-Implement PEP 486 - Make the Python Launcher aware of virtual environments.
+Implement :pep:`486` - Make the Python Launcher aware of virtual environments.
 Patch by Paul Moore.
 
 ..
diff --git a/Misc/NEWS.d/3.5.0a4.rst b/Misc/NEWS.d/3.5.0a4.rst
index eb63a83..f60aa0a 100644
--- a/Misc/NEWS.d/3.5.0a4.rst
+++ b/Misc/NEWS.d/3.5.0a4.rst
@@ -7,7 +7,7 @@
 Under Linux, GNU/KFreeBSD and the Hurd, C extensions now include the
 architecture triplet in the extension name, to make it easy to test builds
 for different ABIs in the same working tree.  Under OS X, the extension name
-now includes PEP 3149-style information.
+now includes :pep:`3149`-style information.
 
 ..
 
@@ -26,7 +26,7 @@ Joe Jevnik.
 .. nonce: FOXb37
 .. section: Core and Builtins
 
-Implement PEP 488: removal of .pyo files.
+Implement :pep:`488`: removal of .pyo files.
 
 ..
 
@@ -495,7 +495,7 @@ modules already mapped with full name mapping.
 
 select.select() is now retried automatically with the recomputed timeout
 when interrupted by a signal, except if the signal handler raises an
-exception. This change is part of the PEP 475.
+exception. This change is part of the :pep:`475`.
 
 ..
 
diff --git a/Misc/NEWS.d/3.5.0b2.rst b/Misc/NEWS.d/3.5.0b2.rst
index 21c75dd..43bf4a8 100644
--- a/Misc/NEWS.d/3.5.0b2.rst
+++ b/Misc/NEWS.d/3.5.0b2.rst
@@ -62,7 +62,7 @@ Fix a crash in the StreamWriter.reset() of CJK codecs.
 .. nonce: M2rJNs
 .. section: Library
 
-Add math.isclose() and cmath.isclose() functions as per PEP 485. Contributed
+Add math.isclose() and cmath.isclose() functions as per :pep:`485`. Contributed
 by Chris Barker and Tal Einat.
 
 ..
diff --git a/Misc/NEWS.d/3.5.0b3.rst b/Misc/NEWS.d/3.5.0b3.rst
index bb4cc33..5e981f8 100644
--- a/Misc/NEWS.d/3.5.0b3.rst
+++ b/Misc/NEWS.d/3.5.0b3.rst
@@ -33,7 +33,7 @@ Add Py_tp_finalize slot for the stable ABI.
 .. nonce: 2mNeD8
 .. section: Core and Builtins
 
-Introduce a distinct type for PEP 492 coroutines; add types.CoroutineType,
+Introduce a distinct type for :pep:`492` coroutines; add types.CoroutineType,
 inspect.getcoroutinestate, inspect.getcoroutinelocals; coroutines no longer
 use CO_GENERATOR flag; sys.set_coroutine_wrapper works only for 'async def'
 coroutines; inspect.iscoroutine no longer uses collections.abc.Coroutine,
diff --git a/Misc/NEWS.d/3.5.0b4.rst b/Misc/NEWS.d/3.5.0b4.rst
index bcc7345..51cefe2 100644
--- a/Misc/NEWS.d/3.5.0b4.rst
+++ b/Misc/NEWS.d/3.5.0b4.rst
@@ -14,7 +14,7 @@ argument on Linux.
 .. nonce: bqh6PQ
 .. section: Core and Builtins
 
-Make PEP 448 dictionary evaluation more consistent.
+Make :pep:`448` dictionary evaluation more consistent.
 
 ..
 
diff --git a/Misc/NEWS.d/3.5.0rc3.rst b/Misc/NEWS.d/3.5.0rc3.rst
index c6976c0..2f770a0 100644
--- a/Misc/NEWS.d/3.5.0rc3.rst
+++ b/Misc/NEWS.d/3.5.0rc3.rst
@@ -23,7 +23,7 @@ Prevent __class__ assignment to immutable built-in objects.
 .. nonce: 2gLdfN
 .. section: Core and Builtins
 
-Fix AST compilation for PEP 448 syntax.
+Fix AST compilation for :pep:`448` syntax.
 
 ..
 
diff --git a/Misc/NEWS.d/3.5.2rc1.rst b/Misc/NEWS.d/3.5.2rc1.rst
index 3d513b3..23486e3 100644
--- a/Misc/NEWS.d/3.5.2rc1.rst
+++ b/Misc/NEWS.d/3.5.2rc1.rst
@@ -300,7 +300,7 @@ Fixed problem with in-place string concatenation and utf-8 cache.
 .. nonce: tCCgmH
 .. section: Core and Builtins
 
-Mention PEP 420 in the importlib docs.
+Mention :pep:`420` in the importlib docs.
 
 ..
 
@@ -423,7 +423,7 @@ A new version of typing.py provides several new classes and features:
 @overload outside stubs, Reversible, DefaultDict, Text, ContextManager,
 Type[], NewType(), TYPE_CHECKING, and numerous bug fixes (note that some of
 the new features are not yet implemented in mypy or other static analyzers).
-Also classes for PEP 492 (Awaitable, AsyncIterable, AsyncIterator) have been
+Also classes for :pep:`492` (Awaitable, AsyncIterable, AsyncIterator) have been
 added (in fact they made it into 3.5.1 but were never mentioned).
 
 ..
@@ -1816,7 +1816,7 @@ Patch by Ammar Askar.
 .. nonce: MUK0zK
 .. section: Documentation
 
-Document the new PEP 448 unpacking syntax of 3.5.
+Document the new :pep:`448` unpacking syntax of 3.5.
 
 ..
 
diff --git a/Misc/NEWS.d/3.5.3rc1.rst b/Misc/NEWS.d/3.5.3rc1.rst
index bca43c8..3a51fad 100644
--- a/Misc/NEWS.d/3.5.3rc1.rst
+++ b/Misc/NEWS.d/3.5.3rc1.rst
@@ -1402,7 +1402,7 @@ Zijlstra.
 When an exception is raised within the context being managed by a
 contextlib.ExitStack() and one of the exit stack generators catches and
 raises it in a chain, do not re-raise the original exception when exiting,
-let the new chained one through.  This avoids the PEP 479 bug described in
+let the new chained one through.  This avoids the :pep:`479` bug described in
 issue25782.
 
 ..
diff --git a/Misc/NEWS.d/3.6.0a1.rst b/Misc/NEWS.d/3.6.0a1.rst
index 254d361..2e259c5 100644
--- a/Misc/NEWS.d/3.6.0a1.rst
+++ b/Misc/NEWS.d/3.6.0a1.rst
@@ -144,7 +144,7 @@ Fix the doc comment for FileFinder.find_spec().
 .. nonce: tCCgmH
 .. section: Core and Builtins
 
-Mention PEP 420 in the importlib docs.
+Mention :pep:`420` in the importlib docs.
 
 ..
 
@@ -203,7 +203,7 @@ Add tests for reloading namespace packages.
 .. nonce: CuMWZJ
 .. section: Core and Builtins
 
-Switch applicable importlib tests to use PEP 451 API.
+Switch applicable importlib tests to use :pep:`451` API.
 
 ..
 
@@ -782,7 +782,7 @@ Patch from Mark Dickinson.
 .. nonce: wfyxbB
 .. section: Core and Builtins
 
-Implement PEP 498 "Literal String Interpolation". This allows you to embed
+Implement :pep:`498` "Literal String Interpolation". This allows you to embed
 expressions inside f-strings, which are converted to normal strings at run
 time. Given x=3, then f'value={x}' == 'value=3'. Patch by Eric V. Smith.
 
@@ -1011,7 +1011,7 @@ Patch by Stefan Krah.
 .. nonce: LR__VD
 .. section: Library
 
-Add secrets module as described in PEP 506.
+Add secrets module as described in :pep:`506`.
 
 ..
 
diff --git a/Misc/NEWS.d/3.6.0a2.rst b/Misc/NEWS.d/3.6.0a2.rst
index 9e7326b..fa050de 100644
--- a/Misc/NEWS.d/3.6.0a2.rst
+++ b/Misc/NEWS.d/3.6.0a2.rst
@@ -44,7 +44,7 @@ Added BUILD_CONST_KEY_MAP opcode.
 .. nonce: EAnCS7
 .. section: Core and Builtins
 
-Add support for os.PathLike objects to open() (part of PEP 519).
+Add support for os.PathLike objects to open() (part of :pep:`519`).
 
 ..
 
@@ -215,7 +215,7 @@ bytes patterns.
 .. nonce: UYiwoh
 .. section: Library
 
-Add os.PathLike support to DirEntry (part of PEP 519). Initial patch by
+Add os.PathLike support to DirEntry (part of :pep:`519`). Initial patch by
 Jelle Zijlstra.
 
 ..
@@ -246,7 +246,7 @@ PEP 519). Initial patch by Dusty Phillips.
 .. section: Library
 
 Add support for os.PathLike objects to os.fsencode() and os.fsdecode() (part
-of PEP 519).
+of :pep:`519`).
 
 ..
 
@@ -255,7 +255,7 @@ of PEP 519).
 .. nonce: y7YRfj
 .. section: Library
 
-Introduce os.PathLike and os.fspath() (part of PEP 519).
+Introduce os.PathLike and os.fspath() (part of :pep:`519`).
 
 ..
 
@@ -268,7 +268,7 @@ A new version of typing.py provides several new classes and features:
 @overload outside stubs, Reversible, DefaultDict, Text, ContextManager,
 Type[], NewType(), TYPE_CHECKING, and numerous bug fixes (note that some of
 the new features are not yet implemented in mypy or other static analyzers).
-Also classes for PEP 492 (Awaitable, AsyncIterable, AsyncIterator) have been
+Also classes for :pep:`492` (Awaitable, AsyncIterable, AsyncIterator) have been
 added (in fact they made it into 3.5.1 but were never mentioned).
 
 ..
@@ -689,7 +689,7 @@ to use lowercase.  Patch by Sean Rodman, test by Kaushik Nadikuditi.
 .. nonce: MUK0zK
 .. section: Documentation
 
-Document the new PEP 448 unpacking syntax of 3.5.
+Document the new :pep:`448` unpacking syntax of 3.5.
 
 ..
 
@@ -770,7 +770,7 @@ https://github.com/python/pythondotorg/issues/945)
 .. nonce: Ll8R-t
 .. section: C API
 
-Add the PyOS_FSPath() function (part of PEP 519).
+Add the PyOS_FSPath() function (part of :pep:`519`).
 
 ..
 
diff --git a/Misc/NEWS.d/3.6.0a3.rst b/Misc/NEWS.d/3.6.0a3.rst
index 2ca2580..4b0000b 100644
--- a/Misc/NEWS.d/3.6.0a3.rst
+++ b/Misc/NEWS.d/3.6.0a3.rst
@@ -243,7 +243,7 @@ Zijlstra.
 When an exception is raised within the context being managed by a
 contextlib.ExitStack() and one of the exit stack generators catches and
 raises it in a chain, do not re-raise the original exception when exiting,
-let the new chained one through.  This avoids the PEP 479 bug described in
+let the new chained one through.  This avoids the :pep:`479` bug described in
 issue25782.
 
 ..
diff --git a/Misc/NEWS.d/3.6.0a4.rst b/Misc/NEWS.d/3.6.0a4.rst
index 0be9c82..d613fd5 100644
--- a/Misc/NEWS.d/3.6.0a4.rst
+++ b/Misc/NEWS.d/3.6.0a4.rst
@@ -122,7 +122,7 @@ SystemError.
 .. nonce: VrInsj
 .. section: Core and Builtins
 
-Implemented PEP 487 (Simpler customization of class creation). Upon
+Implemented :pep:`487` (Simpler customization of class creation). Upon
 subclassing, the __init_subclass__ classmethod is called on the base class.
 Descriptors are initialized with __set_name__ after class creation.
 
@@ -133,7 +133,7 @@ Descriptors are initialized with __set_name__ after class creation.
 .. nonce: nfVMKM
 .. section: Library
 
-Add PEP 519/__fspath__() support to the os and os.path modules. Includes
+Add :pep:`519`/__fspath__() support to the os and os.path modules. Includes
 code from Jelle Zijlstra. (See also: bpo-27524)
 
 ..
@@ -197,7 +197,7 @@ keyword-only.
 .. nonce: nbAEM8
 .. section: Library
 
-Add mathematical constant tau to math and cmath. See also PEP 628.
+Add mathematical constant tau to math and cmath. See also :pep:`628`.
 
 ..
 
@@ -400,7 +400,7 @@ of 4 GiB.
 .. nonce: IDW05R
 .. section: Library
 
-Implemented PEP 495 (Local Time Disambiguation).
+Implemented :pep:`495` (Local Time Disambiguation).
 
 ..
 
@@ -604,7 +604,7 @@ Update bundled Tcl/Tk to 8.6.6.
 .. nonce: O0o0mB
 .. section: Windows
 
-Adds PEP 514 metadata to Windows installer
+Adds :pep:`514` metadata to Windows installer
 
 ..
 
diff --git a/Misc/NEWS.d/3.6.0b1.rst b/Misc/NEWS.d/3.6.0b1.rst
index f151557..bd0e0a7 100644
--- a/Misc/NEWS.d/3.6.0b1.rst
+++ b/Misc/NEWS.d/3.6.0b1.rst
@@ -26,7 +26,7 @@ NSMALLPOSINTS = 0.
 .. nonce: Te4Tjb
 .. section: Core and Builtins
 
-Implement formatting support for PEP 515.  Initial patch by Chris Angelico.
+Implement formatting support for :pep:`515`.  Initial patch by Chris Angelico.
 
 ..
 
@@ -107,7 +107,7 @@ Serhiy Storchaka and Victor Stinner.
 .. nonce: TdJp8_
 .. section: Core and Builtins
 
-Implement tokenizing support for PEP 515. Patch by Georg Brandl.
+Implement tokenizing support for :pep:`515`. Patch by Georg Brandl.
 
 ..
 
@@ -126,7 +126,7 @@ Levkivskyi.
 .. nonce: noeoav
 .. section: Core and Builtins
 
-Implement PEP 525 -- Asynchronous Generators.
+Implement :pep:`525` -- Asynchronous Generators.
 
 ..
 
@@ -135,7 +135,7 @@ Implement PEP 525 -- Asynchronous Generators.
 .. nonce: 0ayJ5k
 .. section: Core and Builtins
 
-Implement PEP 526 -- Syntax for Variable Annotations. Patch by Ivan
+Implement :pep:`526` -- Syntax for Variable Annotations. Patch by Ivan
 Levkivskyi.
 
 ..
@@ -224,7 +224,7 @@ longer a relevant platform for Python.
 .. nonce: rdhhVw
 .. section: Core and Builtins
 
-Implement PEP 523.
+Implement :pep:`523`.
 
 ..
 
@@ -410,7 +410,7 @@ Patch written by Xiang Zhang.
 .. nonce: 0DdIrA
 .. section: Core and Builtins
 
-Implement PEP 530 -- asynchronous comprehensions.
+Implement :pep:`530` -- asynchronous comprehensions.
 
 ..
 
diff --git a/Misc/NEWS.d/3.6.0rc1.rst b/Misc/NEWS.d/3.6.0rc1.rst
index 17220ca..c44dec3 100644
--- a/Misc/NEWS.d/3.6.0rc1.rst
+++ b/Misc/NEWS.d/3.6.0rc1.rst
@@ -110,7 +110,7 @@ PyUnicode_CompareWithASCIIString() now never raises exceptions.
 
 The data model reference and the porting section in the What's New guide now
 cover the additional ``__classcell__`` handling needed for custom
-metaclasses to fully support PEP 487 and zero-argument ``super()``.
+metaclasses to fully support :pep:`487` and zero-argument ``super()``.
 
 ..
 
diff --git a/Misc/NEWS.d/3.6.1rc1.rst b/Misc/NEWS.d/3.6.1rc1.rst
index 9137df6..1f9fb13 100644
--- a/Misc/NEWS.d/3.6.1rc1.rst
+++ b/Misc/NEWS.d/3.6.1rc1.rst
@@ -465,7 +465,7 @@ Patch written by Jiajun Huang.
 .. nonce: kN5S6v
 .. section: Library
 
-functools.lru_cache() now respects PEP 468 and preserves the order of
+functools.lru_cache() now respects :pep:`468` and preserves the order of
 keyword arguments.  f(a=1, b=2) is now cached separately from f(b=2, a=1)
 since both calls could potentially give different results.
 
@@ -689,7 +689,7 @@ Correctly handle special console filenames (patch by Eryk Sun)
 .. nonce: bhvrJ2
 .. section: Windows
 
-Implement PEP 529 for io.FileIO (Patch by Eryk Sun)
+Implement :pep:`529` for io.FileIO (Patch by Eryk Sun)
 
 ..
 
diff --git a/Misc/NEWS.d/3.6.3rc1.rst b/Misc/NEWS.d/3.6.3rc1.rst
index ca812c6..9c9eac6 100644
--- a/Misc/NEWS.d/3.6.3rc1.rst
+++ b/Misc/NEWS.d/3.6.3rc1.rst
@@ -406,7 +406,7 @@ avoid keeping a reference to yielded objects.
 .. nonce: nmAvfu
 .. section: Library
 
-Fix ctypes producing wrong PEP 3118 type codes for integer types.
+Fix ctypes producing wrong :pep:`3118` type codes for integer types.
 
 ..
 
@@ -1252,7 +1252,7 @@ by Cheryl Sabella.
 .. section: Tools/Demos
 
 gdb integration commands (py-bt, etc.) work on optimized shared builds now,
-too.  PEP 523 introduced _PyEval_EvalFrameDefault which inlines
+too.  :pep:`523` introduced _PyEval_EvalFrameDefault which inlines
 PyEval_EvalFrameEx on non-debug shared builds.  This broke the ability to
 use py-bt, py-up, and a few other Python-specific gdb integrations. The
 problem is fixed by only looking for _PyEval_EvalFrameDefault frames in
diff --git a/Misc/NEWS.d/3.6.6rc1.rst b/Misc/NEWS.d/3.6.6rc1.rst
index f603876..71a5c3e 100644
--- a/Misc/NEWS.d/3.6.6rc1.rst
+++ b/Misc/NEWS.d/3.6.6rc1.rst
@@ -376,7 +376,7 @@ implementation.
 .. nonce: pyR0jB
 .. section: Library
 
-Update difflib.mdiff() for PEP 479.  Convert an uncaught StopIteration in a
+Update difflib.mdiff() for :pep:`479`.  Convert an uncaught StopIteration in a
 generator into a return-statement.
 
 ..
diff --git a/Misc/NEWS.d/3.7.0a1.rst b/Misc/NEWS.d/3.7.0a1.rst
index 0c13bf0..c8d061e 100644
--- a/Misc/NEWS.d/3.7.0a1.rst
+++ b/Misc/NEWS.d/3.7.0a1.rst
@@ -426,7 +426,7 @@ expression, and generator expressions and comprehensions.
 .. nonce: f_IHor
 .. section: Core and Builtins
 
-Implement PEP 538 (legacy C locale coercion). This means that when a
+Implement :pep:`538` (legacy C locale coercion). This means that when a
 suitable coercion target locale is available, both the core interpreter and
 locale-aware C extensions will assume the use of UTF-8 as the default text
 encoding, rather than ASCII.
@@ -948,7 +948,7 @@ The preferred encoding is UTF-8 on Android. Patch written by Chi Hsuan Yen.
 .. nonce: 2a8zxB
 .. section: Core and Builtins
 
-Clean up interpreter startup (see PEP 432).
+Clean up interpreter startup (see :pep:`432`).
 
 ..
 
@@ -1774,7 +1774,7 @@ Fix ``fileinput.FileInput(files, inplace=True)`` when ``files`` contain
 .. nonce: nmAvfu
 .. section: Library
 
-Fix ctypes producing wrong PEP 3118 type codes for integer types.
+Fix ctypes producing wrong :pep:`3118` type codes for integer types.
 
 ..
 
@@ -4877,7 +4877,7 @@ Fix Python 2 syntax in code for building the documentation.
 
 The data model reference and the porting section in the 3.6 What's New guide
 now cover the additional ``__classcell__`` handling needed for custom
-metaclasses to fully support PEP 487 and zero-argument ``super()``.
+metaclasses to fully support :pep:`487` and zero-argument ``super()``.
 
 ..
 
@@ -5106,7 +5106,7 @@ difficult to maintain low-level internal code.
 .. nonce: XLuZFk
 .. section: Build
 
-Per PEP 11, support for the IRIX operating system was removed.
+Per :pep:`11`, support for the IRIX operating system was removed.
 
 ..
 
@@ -6225,7 +6225,7 @@ description of the configuration system.
 .. section: Tools/Demos
 
 gdb integration commands (py-bt, etc.) work on optimized shared builds now,
-too.  PEP 523 introduced _PyEval_EvalFrameDefault which inlines
+too.  :pep:`523` introduced _PyEval_EvalFrameDefault which inlines
 PyEval_EvalFrameEx on non-debug shared builds.  This broke the ability to
 use py-bt, py-up, and a few other Python-specific gdb integrations. The
 problem is fixed by only looking for _PyEval_EvalFrameDefault frames in
diff --git a/Misc/NEWS.d/3.7.0a2.rst b/Misc/NEWS.d/3.7.0a2.rst
index 363899e..b1b7c92 100644
--- a/Misc/NEWS.d/3.7.0a2.rst
+++ b/Misc/NEWS.d/3.7.0a2.rst
@@ -249,7 +249,7 @@ by Oren Milman.
 .. nonce: _kr47t
 .. section: Core and Builtins
 
-Make ``async`` and ``await`` proper keywords, as specified in PEP 492.
+Make ``async`` and ``await`` proper keywords, as specified in :pep:`492`.
 
 ..
 
@@ -680,7 +680,7 @@ and Py_SetPath()
 .. nonce: vm8vGE
 .. section: C API
 
-Implement PEP 539 for Thread Specific Storage (TSS) API: it is a new Thread
+Implement :pep:`539` for Thread Specific Storage (TSS) API: it is a new Thread
 Local Storage (TLS) API to CPython which would supersede use of the existing
 TLS API within the CPython interpreter, while deprecating the existing API.
 PEP written by Erik M. Bray, patch by Masayuki Yamamoto.
diff --git a/Misc/NEWS.d/3.7.0a3.rst b/Misc/NEWS.d/3.7.0a3.rst
index 176441e..307ea54 100644
--- a/Misc/NEWS.d/3.7.0a3.rst
+++ b/Misc/NEWS.d/3.7.0a3.rst
@@ -552,7 +552,7 @@ Patch by Dong-hee Na.
 .. nonce: YMQ7Q2
 .. section: Library
 
-inspect.signature should follow PEP 8, if the parameter has an annotation
+inspect.signature should follow :pep:`8`, if the parameter has an annotation
 and a default value. Patch by Dong-hee Na.
 
 ..
diff --git a/Misc/NEWS.d/3.7.0b4.rst b/Misc/NEWS.d/3.7.0b4.rst
index a6cae28..55c6068 100644
--- a/Misc/NEWS.d/3.7.0b4.rst
+++ b/Misc/NEWS.d/3.7.0b4.rst
@@ -216,7 +216,7 @@ implementation.
 .. nonce: pyR0jB
 .. section: Library
 
-Update difflib.mdiff() for PEP 479.  Convert an uncaught StopIteration in a
+Update difflib.mdiff() for :pep:`479`.  Convert an uncaught StopIteration in a
 generator into a return-statement.
 
 ..
diff --git a/Misc/NEWS.d/3.7.0b5.rst b/Misc/NEWS.d/3.7.0b5.rst
index 4fe3ed5..2047699 100644
--- a/Misc/NEWS.d/3.7.0b5.rst
+++ b/Misc/NEWS.d/3.7.0b5.rst
@@ -475,7 +475,7 @@ Document that `asyncio.wait()` does not cancel its futures on timeout.
 .. nonce: S1LGPa
 .. section: Documentation
 
-Document PEP 567 changes to asyncio.
+Document :pep:`567` changes to asyncio.
 
 ..
 
diff --git a/Misc/NEWS.d/3.7.0rc1.rst b/Misc/NEWS.d/3.7.0rc1.rst
index bc3cc8e..89457ef 100644
--- a/Misc/NEWS.d/3.7.0rc1.rst
+++ b/Misc/NEWS.d/3.7.0rc1.rst
@@ -168,7 +168,7 @@ Emit a deprecation warning for inspect.formatargspec
 .. nonce: r4z9MM
 .. section: Documentation
 
-Clarified the relationship between PEP 538's PYTHONCOERCECLOCALE and PEP
+Clarified the relationship between :pep:`538`'s PYTHONCOERCECLOCALE and PEP
 540's PYTHONUTF8 mode.
 
 ..
diff --git a/Misc/NEWS.d/next/Documentation/2018-05-23-11-59-51.bpo-32436.S1LGPa.rst b/Misc/NEWS.d/next/Documentation/2018-05-23-11-59-51.bpo-32436.S1LGPa.rst
index 8eeb561..a4ecc23 100644
--- a/Misc/NEWS.d/next/Documentation/2018-05-23-11-59-51.bpo-32436.S1LGPa.rst
+++ b/Misc/NEWS.d/next/Documentation/2018-05-23-11-59-51.bpo-32436.S1LGPa.rst
@@ -1 +1 @@
-Document PEP 567 changes to asyncio.
+Document :pep:`567` changes to asyncio.
diff --git a/Misc/NEWS.d/next/Documentation/2018-06-08-23-46-01.bpo-33409.r4z9MM.rst b/Misc/NEWS.d/next/Documentation/2018-06-08-23-46-01.bpo-33409.r4z9MM.rst
index 5b1a018..f26ddd8 100644
--- a/Misc/NEWS.d/next/Documentation/2018-06-08-23-46-01.bpo-33409.r4z9MM.rst
+++ b/Misc/NEWS.d/next/Documentation/2018-06-08-23-46-01.bpo-33409.r4z9MM.rst
@@ -1,2 +1,2 @@
-Clarified the relationship between PEP 538's PYTHONCOERCECLOCALE and PEP
+Clarified the relationship between :pep:`538`'s PYTHONCOERCECLOCALE and PEP
 540's PYTHONUTF8 mode.
diff --git a/Misc/NEWS.d/next/Documentation/2018-10-22-14-17-57.bpo-35042.1UGv1a.rst b/Misc/NEWS.d/next/Documentation/2018-10-22-14-17-57.bpo-35042.1UGv1a.rst
new file mode 100644
index 0000000..3ebbd3a
--- /dev/null
+++ b/Misc/NEWS.d/next/Documentation/2018-10-22-14-17-57.bpo-35042.1UGv1a.rst
@@ -0,0 +1 @@
+Replace PEP XYZ by the pep role and allow to use the direct links to the PEPs.
diff --git a/Misc/NEWS.d/next/Library/2018-04-04-23-41-30.bpo-33224.pyR0jB.rst b/Misc/NEWS.d/next/Library/2018-04-04-23-41-30.bpo-33224.pyR0jB.rst
index 87ff100..b0ddba9 100644
--- a/Misc/NEWS.d/next/Library/2018-04-04-23-41-30.bpo-33224.pyR0jB.rst
+++ b/Misc/NEWS.d/next/Library/2018-04-04-23-41-30.bpo-33224.pyR0jB.rst
@@ -1,2 +1,2 @@
-Update difflib.mdiff() for PEP 479.  Convert an uncaught StopIteration in a
+Update difflib.mdiff() for :pep:`479`.  Convert an uncaught StopIteration in a
 generator into a return-statement.