summaryrefslogtreecommitdiffstats
path: root/Doc/tutorial
diff options
context:
space:
mode:
authorMiss Islington (bot) <31488909+miss-islington@users.noreply.github.com>2018-10-20 00:43:35 (GMT)
committerGitHub <noreply@github.com>2018-10-20 00:43:35 (GMT)
commitefc09a9701543f7180fc7ea0b6c45cf198c29cb8 (patch)
tree4e99d268876b0170ffa09c8243f6d063dbd36636 /Doc/tutorial
parent932ebc1e0ef9b0d5cd17370f5183bad0257d36f9 (diff)
downloadcpython-efc09a9701543f7180fc7ea0b6c45cf198c29cb8.zip
cpython-efc09a9701543f7180fc7ea0b6c45cf198c29cb8.tar.gz
cpython-efc09a9701543f7180fc7ea0b6c45cf198c29cb8.tar.bz2
bpo-21196: Clarify name mangling rules in tutorial (GH-5667)
Initial patch by Chandan Kumar. (cherry picked from commit 13ae4d44381a647aadd09b70b24833052659be41) Co-authored-by: Berker Peksag <berker.peksag@gmail.com>
Diffstat (limited to 'Doc/tutorial')
-rw-r--r--Doc/tutorial/classes.rst5
1 files changed, 5 insertions, 0 deletions
diff --git a/Doc/tutorial/classes.rst b/Doc/tutorial/classes.rst
index f26838c..487d535 100644
--- a/Doc/tutorial/classes.rst
+++ b/Doc/tutorial/classes.rst
@@ -703,6 +703,11 @@ breaking intraclass method calls. For example::
for item in zip(keys, values):
self.items_list.append(item)
+The above example would work even if ``MappingSubclass`` were to introduce a
+``__update`` identifier since it is replaced with ``_Mapping__update`` in the
+``Mapping`` class and ``_MappingSubclass__update`` in the ``MappingSubclass``
+class respectively.
+
Note that the mangling rules are designed mostly to avoid accidents; it still is
possible to access or modify a variable that is considered private. This can
even be useful in special circumstances, such as in the debugger.