From: Batuhan Taskaya <batuhanosmantaskaya@gmail.com>
Date: Thu, 22 Oct 2020 16:02:43 +0000 (+0300)
Subject: bpo-42086: Document AST operator nodes acts as a singleton (GH-22896)
X-Git-Tag: v3.10.0a2~106
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=b37c994e5ac73268abe23c52005b80cdca099793;p=thirdparty%2FPython%2Fcpython.git

bpo-42086: Document AST operator nodes acts as a singleton (GH-22896)



Automerge-Triggered-By: GH:gvanrossum
---

diff --git a/Doc/library/ast.rst b/Doc/library/ast.rst
index f95ee1d5c69c..b8688ae61a48 100644
--- a/Doc/library/ast.rst
+++ b/Doc/library/ast.rst
@@ -1503,6 +1503,13 @@ Async and await
    fields as :class:`For` and :class:`With`, respectively. Only valid in the
    body of an :class:`AsyncFunctionDef`.
 
+.. note::
+   When a string is parsed by :func:`ast.parse`, operator nodes (subclasses
+   of :class:`ast.operator`, :class:`ast.unaryop`, :class:`ast.cmpop`,
+   :class:`ast.boolop` and :class:`ast.expr_context`) on the returned tree
+   will be singletons. Changes to one will be reflected in all other
+   occurrences of the same value (e.g. :class:`ast.Add`).
+
 
 :mod:`ast` Helpers
 ------------------