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

2 files changed

lines changed

Original file line numberDiff line numberDiff line change

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

667667
668668

.. seealso::

669669
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+
671675

:pep:`3129` - Class Decorators

676+

The proposal that added class decorators. Function and method decorators

677+

were introduced in :pep:`318`.

672678
673679
674680

Coroutines

@@ -793,6 +799,8 @@ It is a :exc:`SyntaxError` to use ``async with`` statement outside of an

793799

.. seealso::

794800
795801

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

796804
797805
798806

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