From bc64123335a4b6e2c1e4be532c60e5e1086db59a Mon Sep 17 00:00:00 2001 From: "Miss Islington (bot)" <31488909+miss-islington@users.noreply.github.com> Date: Sun, 23 Dec 2018 21:18:39 -0800 Subject: [PATCH] bpo-35566: Add links to annotation glossary term (GH-11291) (GH-11302) --- Doc/library/dataclasses.rst | 6 +++--- Doc/reference/compound_stmts.rst | 4 ++-- Doc/reference/simple_stmts.rst | 4 ++-- Doc/tutorial/controlflow.rst | 8 ++++---- 4 files changed, 11 insertions(+), 11 deletions(-) diff --git a/Doc/library/dataclasses.rst b/Doc/library/dataclasses.rst index fe0feeda8b8..6af60b6e269 100644 --- a/Doc/library/dataclasses.rst +++ b/Doc/library/dataclasses.rst @@ -51,9 +51,9 @@ Module-level decorators, classes, and functions The :func:`dataclass` decorator examines the class to find ``field``\s. A ``field`` is defined as class variable that has a - type annotation. With two exceptions described below, nothing in - :func:`dataclass` examines the type specified in the variable - annotation. + :term:`type annotation `. With two + exceptions described below, nothing in :func:`dataclass` + examines the type specified in the variable annotation. The order of the fields in all of the generated methods is the order in which they appear in the class definition. diff --git a/Doc/reference/compound_stmts.rst b/Doc/reference/compound_stmts.rst index db453fcdd1e..1d84274b799 100644 --- a/Doc/reference/compound_stmts.rst +++ b/Doc/reference/compound_stmts.rst @@ -570,8 +570,8 @@ used keyword arguments. single: ->; function annotations single: : (colon); function annotations -Parameters may have annotations of the form "``: expression``" following the -parameter name. Any parameter may have an annotation even those of the form +Parameters may have an :term:`annotation ` of the form "``: expression``" +following the parameter name. Any parameter may have an annotation, even those of the form ``*identifier`` or ``**identifier``. Functions may have "return" annotation of the form "``-> expression``" after the parameter list. These annotations can be any valid Python expression. The presence of annotations does not change the diff --git a/Doc/reference/simple_stmts.rst b/Doc/reference/simple_stmts.rst index dcda309b58d..07072d95438 100644 --- a/Doc/reference/simple_stmts.rst +++ b/Doc/reference/simple_stmts.rst @@ -325,8 +325,8 @@ Annotated assignment statements single: statement; assignment, annotated single: : (colon); annotated variable -Annotation assignment is the combination, in a single statement, -of a variable or attribute annotation and an optional assignment statement: +:term:`Annotation ` assignment is the combination, in a single +statement, of a variable or attribute annotation and an optional assignment statement: .. productionlist:: annotated_assignment_stmt: `augtarget` ":" `expression` ["=" `expression`] diff --git a/Doc/tutorial/controlflow.rst b/Doc/tutorial/controlflow.rst index 08eaa66a406..905734539c6 100644 --- a/Doc/tutorial/controlflow.rst +++ b/Doc/tutorial/controlflow.rst @@ -682,10 +682,10 @@ Function Annotations information about the types used by user-defined functions (see :pep:`3107` and :pep:`484` for more information). -Annotations are stored in the :attr:`__annotations__` attribute of the function -as a dictionary and have no effect on any other part of the function. Parameter -annotations are defined by a colon after the parameter name, followed by an -expression evaluating to the value of the annotation. Return annotations are +:term:`Annotations ` are stored in the :attr:`__annotations__` +attribute of the function as a dictionary and have no effect on any other part of the +function. Parameter annotations are defined by a colon after the parameter name, followed +by an expression evaluating to the value of the annotation. Return annotations are defined by a literal ``->``, followed by an expression, between the parameter list and the colon denoting the end of the :keyword:`def` statement. The following example has a positional argument, a keyword argument, and the return