From 70102ff18817dd3db79cf73a1028251bbf2106f2 Mon Sep 17 00:00:00 2001 From: "Miss Islington (bot)" <31488909+miss-islington@users.noreply.github.com> Date: Fri, 19 Oct 2018 16:44:31 -0700 Subject: [PATCH] bpo-33726, doc: Add short descriptions to PEP references in seealso (GH-7294) MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit (cherry picked from commit 0f14fc1a7cb2ea0012d0a943e4460acdee2108d7) Co-authored-by: Andrés Delfino --- Doc/reference/compound_stmts.rst | 10 +++++++++- Doc/reference/simple_stmts.rst | 9 ++++++++- 2 files changed, 17 insertions(+), 2 deletions(-) diff --git a/Doc/reference/compound_stmts.rst b/Doc/reference/compound_stmts.rst index 1f753308e398..bd5cb104a0f5 100644 --- a/Doc/reference/compound_stmts.rst +++ b/Doc/reference/compound_stmts.rst @@ -667,8 +667,14 @@ can be used to create instance variables with different implementation details. .. seealso:: - :pep:`3115` - Metaclasses in Python 3 + :pep:`3115` - Metaclasses in Python 3000 + The proposal that changed the declaration of metaclasses to the current + syntax, and the semantics for how classes with metaclasses are + constructed. + :pep:`3129` - Class Decorators + The proposal that added class decorators. Function and method decorators + were introduced in :pep:`318`. Coroutines @@ -793,6 +799,8 @@ It is a :exc:`SyntaxError` to use ``async with`` statement outside of an .. seealso:: :pep:`492` - Coroutines with async and await syntax + The proposal that made coroutines a proper standalone concept in Python, + and added supporting syntax. .. rubric:: Footnotes diff --git a/Doc/reference/simple_stmts.rst b/Doc/reference/simple_stmts.rst index 76630dfc590f..f54e2c9d3f06 100644 --- a/Doc/reference/simple_stmts.rst +++ b/Doc/reference/simple_stmts.rst @@ -353,8 +353,15 @@ target, then the interpreter evaluates the target except for the last .. seealso:: - :pep:`526` - Variable and attribute annotation syntax + :pep:`526` - Syntax for Variable Annotations + The proposal that added syntax for annotating the types of variables + (including class variables and instance variables), instead of expressing + them through comments. + :pep:`484` - Type hints + The proposal that added the :mod:`typing` module to provide a standard + syntax for type annotations that can be used in static analysis tools and + IDEs. .. _assert: -- 2.47.3