changeset: 83646:e2a805281d26
branch: 3.3
parent: 83640:bb4bb2db6106
user: R David Murray <rdmurray@bitdance.com>
date: Mon May 06 12:58:16 2013 -0400
files: Doc/glossary.rst
description:
#14187: Add glossary entry for 'function annotations'.
Patch by Chris Rebert.
diff -r bb4bb2db6106 -r e2a805281d26 Doc/glossary.rst
--- a/Doc/glossary.rst	Mon May 06 12:10:04 2013 +0100
+++ b/Doc/glossary.rst	Mon May 06 12:58:16 2013 -0400
@@ -252,6 +252,16 @@
 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.
</div><div class="naked_ctrl">
<form action="/index.cgi/contrast" method="get" name="gate">
<p><a href="http://altstyle.alfasado.net">AltStyle</a> によって変換されたページ <a href="https://hg.python.org/cpython/rev/e2a805281d26">(-&gt;オリジナル)</a>
/ <label>アドレス: <input type="text" name="naked_post_url" value="https://hg.python.org/cpython/rev/e2a805281d26" size="22" /></label> <label>モード: <select name="naked_post_mode">
<option value="default">デフォルト</option>
<option value="speech">音声ブラウザ</option>
<option value="ruby">ルビ付き</option>
<option value="contrast" selected="selected">配色反転</option>
<option value="larger-text">文字拡大</option>
<option value="mobile">モバイル</option>
</select>
<input type="submit" value="表示" />
</p>
</form>
</div>