From: Nikita Sobolev <mail@sobolevn.me>
Date: Fri, 7 Oct 2022 18:54:45 +0000 (+0300)
Subject: gh-97956: Mention `generate_global_objects.py` in `AC How-To` (#97957)
X-Git-Tag: v3.12.0a1~181
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=586cfb01311cac1defb883b928fbb368d6d38e55;p=thirdparty%2FPython%2Fcpython.git

gh-97956: Mention `generate_global_objects.py` in `AC How-To` (#97957)
---

diff --git a/Doc/howto/clinic.rst b/Doc/howto/clinic.rst
index d634c4b47db9..b8afc7e6d762 100644
--- a/Doc/howto/clinic.rst
+++ b/Doc/howto/clinic.rst
@@ -539,7 +539,15 @@ Let's dive in!
         };
 
 
-16. Compile, then run the relevant portions of the regression-test suite.
+16. Argument Clinic may generate new instances of ``_Py_ID``. For example::
+
+        &_Py_ID(new_unique_py_id)
+
+    If it does, you'll have to run ``Tools/scripts/generate_global_objects.py``
+    to regenerate the list of precompiled identifiers at this point.
+
+
+17. Compile, then run the relevant portions of the regression-test suite.
     This change should not introduce any new compile-time warnings or errors,
     and there should be no externally visible change to Python's behavior.