#14187: Add glossary entry for 'function annotations'.

Patch by Chris Rebert.
This commit is contained in:
R David Murray 2013-05-06 12:58:16 -04:00
parent def51ca8ea
commit 25cd09115d
1 changed files with 10 additions and 0 deletions

View File

@ -252,6 +252,16 @@ Glossary
the execution of the body. See also :term:`parameter`, :term:`method`,
and the :ref:`function` section.
function annotation
An arbitrary metadata value associated with a function parameter or return
value. Its syntax is explained in section :ref:`function`. Annotations
may be accessed via the :attr:`__annotations__` special attribute of a
function object.
Python itself does not assign any particular meaning to function
annotations. They are intended to be interpreted by third-party libraries
or tools. See :pep:`3107`, which describes some of their potential uses.
__future__
A pseudo-module which programmers can use to enable new language features
which are not compatible with the current interpreter.