[Python-checkins] bpo-33726, doc: Add short descriptions to PEP references in seealso (GH-7294)

[Miss Islington (bot)]

https://github.com/python/cpython/commit/70102ff18817dd3db79cf73a1028251bbf2106f2
commit: 70102ff18817dd3db79cf73a1028251bbf2106f2
branch: 3.6
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: GitHub <noreply at github.com>
date: 2018-10-19T16:44:31-07:00
summary:

bpo-33726, doc: Add short descriptions to PEP references in seealso (GH-7294)

(cherry picked from commit 0f14fc1a7cb2ea0012d0a943e4460acdee2108d7)

Co-authored-by: Andrés Delfino <adelfino at gmail.com>

files:
M Doc/reference/compound_stmts.rst
M Doc/reference/simple_stmts.rst

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: