bpo-33726, doc: Add short descriptions to PEP references in seealso (… · python/cpython@0f14fc1

2 files changed

lines changed

Original file line numberDiff line numberDiff line change

@@ -681,8 +681,14 @@ can be used to create instance variables with different implementation details.

681681
682682

.. seealso::

683683
684-

:pep:`3115` - Metaclasses in Python 3

684+

:pep:`3115` - Metaclasses in Python 3000

685+

The proposal that changed the declaration of metaclasses to the current

686+

syntax, and the semantics for how classes with metaclasses are

687+

constructed.

688+
685689

:pep:`3129` - Class Decorators

690+

The proposal that added class decorators. Function and method decorators

691+

were introduced in :pep:`318`.

686692
687693
688694

.. _async:

@@ -809,6 +815,8 @@ coroutine.

809815

.. seealso::

810816
811817

:pep:`492` - Coroutines with async and await syntax

818+

The proposal that made coroutines a proper standalone concept in Python,

819+

and added supporting syntax.

812820
813821
814822

.. rubric:: Footnotes

Original file line numberDiff line numberDiff line change

@@ -353,8 +353,15 @@ target, then the interpreter evaluates the target except for the last

353353
354354

.. seealso::

355355
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+
357361

: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.

358365
359366
360367

.. _assert: