summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorGeorg Brandl <georg@python.org>2010-08-02 19:32:43 (GMT)
committerGeorg Brandl <georg@python.org>2010-08-02 19:32:43 (GMT)
commit7d180a0da1eef4aff2ac1149f04a52997b380ef6 (patch)
tree4738cbd8cc8f9e1eaef9bd9aa7fa467f806b18df /Doc
parent7528b9b8acb3c593aa36b25a26476b5588139e26 (diff)
downloadcpython-7d180a0da1eef4aff2ac1149f04a52997b380ef6.zip
cpython-7d180a0da1eef4aff2ac1149f04a52997b380ef6.tar.gz
cpython-7d180a0da1eef4aff2ac1149f04a52997b380ef6.tar.bz2
#9451: strengthen warning about __*__ special name usage.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/reference/lexical_analysis.rst11
1 files changed, 6 insertions, 5 deletions
diff --git a/Doc/reference/lexical_analysis.rst b/Doc/reference/lexical_analysis.rst
index 1b8b7b5..51a291e 100644
--- a/Doc/reference/lexical_analysis.rst
+++ b/Doc/reference/lexical_analysis.rst
@@ -362,11 +362,12 @@ characters:
information on this convention.
``__*__``
- System-defined names. These names are defined by the interpreter and its
- implementation (including the standard library); applications should not expect
- to define additional names using this convention. The set of names of this
- class defined by Python may be extended in future versions. See section
- :ref:`specialnames`.
+ System-defined names. These names are defined by the interpreter and its
+ implementation (including the standard library). Current system names are
+ discussed in the :ref:`specialnames` section and elsewhere. More will likely
+ be defined in future versions of Python. *Any* use of ``__*__`` names, in
+ any context, that does not follow explicitly documented use, is subject to
+ breakage without warning.
``__*``
Class-private names. Names in this category, when used within the context of a