From: Neil Schemenauer <nas-github@arctrix.com>
Date: Thu, 27 Mar 2025 08:30:25 +0000 (-0700)
Subject: Revise `pycore_stackref.h` comments. (#130601)
X-Git-Tag: v3.14.0a7~174
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=316938bddf1d321234debecc4561d8f5cd6403a0;p=thirdparty%2FPython%2Fcpython.git

Revise `pycore_stackref.h` comments. (#130601)
---

diff --git a/Include/internal/pycore_stackref.h b/Include/internal/pycore_stackref.h
index 80e8f4f365f1..e2e32ed41228 100644
--- a/Include/internal/pycore_stackref.h
+++ b/Include/internal/pycore_stackref.h
@@ -35,13 +35,13 @@ extern "C" {
   unboxed integers harder in the future.
 
   Steal means that ownership is transferred to something else. The total
-  number of references to the object stays the same.
+  number of references to the object stays the same.  The old reference is no
+  longer valid.
 
   New creates a new reference from the old reference. The old reference
   is still valid.
 
-  With these 3 API, a strict stack discipline must be maintained. All
-  _PyStackRef must be operated on by the new reference operations:
+  All _PyStackRef must be operated on by the new reference operations:
 
     1. DUP
     2. CLOSE