From: Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com>
Date: Fri, 13 Nov 2020 09:05:41 +0000 (-0800)
Subject: [3.9] bpo-42086: Document AST operator nodes acts as a singleton (GH-22896) (GH-22897)
X-Git-Tag: v3.9.1rc1~52
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=bc777047833256bc6b10b2c7b46cce9e9e6f956c;p=thirdparty%2FPython%2Fcpython.git

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



Automerge-Triggered-By: GH:gvanrossum
(cherry picked from commit b37c994e5ac73268abe23c52005b80cdca099793)


Co-authored-by: Batuhan Taskaya <batuhanosmantaskaya@gmail.com>
---

diff --git a/Doc/library/ast.rst b/Doc/library/ast.rst
index 932f7258f9dc..95cb017d145c 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
 ------------------