bpo-33726, doc: Add short descriptions to PEP references in seealso (… · python/cpython@70102ff (original) (raw)

2 files changed

lines changed

Original file line number Diff line number Diff line change
@@ -667,8 +667,14 @@ can be used to create instance variables with different implementation details.
667 667
668 668 .. seealso::
669 669
670 -:pep:`3115` - Metaclasses in Python 3
670 +:pep:`3115` - Metaclasses in Python 3000
671 + The proposal that changed the declaration of metaclasses to the current
672 + syntax, and the semantics for how classes with metaclasses are
673 + constructed.
674 +
671 675 :pep:`3129` - Class Decorators
676 + The proposal that added class decorators. Function and method decorators
677 + were introduced in :pep:`318`.
672 678
673 679
674 680 Coroutines
@@ -793,6 +799,8 @@ It is a :exc:`SyntaxError` to use ``async with`` statement outside of an
793 799 .. seealso::
794 800
795 801 :pep:`492` - Coroutines with async and await syntax
802 + The proposal that made coroutines a proper standalone concept in Python,
803 + and added supporting syntax.
796 804
797 805
798 806 .. rubric:: Footnotes
Original file line number Diff line number Diff line change
@@ -353,8 +353,15 @@ target, then the interpreter evaluates the target except for the last
353 353
354 354 .. seealso::
355 355
356 -:pep:`526` - Variable and attribute annotation syntax
356 +:pep:`526` - Syntax for Variable Annotations
357 + The proposal that added syntax for annotating the types of variables
358 + (including class variables and instance variables), instead of expressing
359 + them through comments.
360 +
357 361 :pep:`484` - Type hints
362 + The proposal that added the :mod:`typing` module to provide a standard
363 + syntax for type annotations that can be used in static analysis tools and
364 + IDEs.
358 365
359 366
360 367 .. _assert: