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

2 files changed

lines changed

Original file line number Diff line number Diff line change
@@ -680,8 +680,14 @@ can be used to create instance variables with different implementation details.
680 680
681 681 .. seealso::
682 682
683 -:pep:`3115` - Metaclasses in Python 3
683 +:pep:`3115` - Metaclasses in Python 3000
684 + The proposal that changed the declaration of metaclasses to the current
685 + syntax, and the semantics for how classes with metaclasses are
686 + constructed.
687 +
684 688 :pep:`3129` - Class Decorators
689 + The proposal that added class decorators. Function and method decorators
690 + were introduced in :pep:`318`.
685 691
686 692
687 693 .. _async:
@@ -808,6 +814,8 @@ coroutine.
808 814 .. seealso::
809 815
810 816 :pep:`492` - Coroutines with async and await syntax
817 + The proposal that made coroutines a proper standalone concept in Python,
818 + and added supporting syntax.
811 819
812 820
813 821 .. 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: