From b7105c9c9663637e4500bfcac75c911e78d9a1c0 Mon Sep 17 00:00:00 2001 From: Cheryl Sabella Date: Mon, 24 Dec 2018 00:09:09 -0500 Subject: [PATCH] bpo-35566: Add links to annotation glossary term (GH-11291) --- 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 072a500d9f8..db5c3e0c7e2 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 a83b561c13f..42fa8647623 100644 --- a/Doc/reference/compound_stmts.rst +++ b/Doc/reference/compound_stmts.rst @@ -571,8 +571,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 0efbe1ce5d5..00964afc6d3 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