From: Tim Peters <tim@python.org>
Date: Fri, 20 Sep 2013 02:06:37 +0000 (-0500)
Subject: Update internal comments to say _something_ about the "API ID".
X-Git-Tag: v3.4.0a3~42
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=df099f5df672c6f431dcf7ef276c462bebc13919;p=thirdparty%2FPython%2Fcpython.git

Update internal comments to say _something_ about the "API ID".

Best I can tell, the possible values for this aren't documented anywhere.
---

diff --git a/Misc/SpecialBuilds.txt b/Misc/SpecialBuilds.txt
index f869e7c05e67..646ac2344cb3 100644
--- a/Misc/SpecialBuilds.txt
+++ b/Misc/SpecialBuilds.txt
@@ -105,7 +105,9 @@ negative indices differs from a Python slice):
 p[-2*S:-S]
     Number of bytes originally asked for.  This is a size_t, big-endian (easier
     to read in a memory dump).
-p[-S:0]
+p[-S]
+    API ID.  See PEP 445.  This is a character, but seems undocumented.
+p[-S+1:0]
     Copies of FORBIDDENBYTE.  Used to catch under- writes and reads.
 p[0:N]
     The requested memory, filled with copies of CLEANBYTE, used to catch
diff --git a/Objects/obmalloc.c b/Objects/obmalloc.c
index db774b8423f7..2ab66a33b92f 100644
--- a/Objects/obmalloc.c
+++ b/Objects/obmalloc.c
@@ -1702,7 +1702,9 @@ pool_is_in_list(const poolp target, poolp list)
 p[0: S]
     Number of bytes originally asked for.  This is a size_t, big-endian (easier
     to read in a memory dump).
-p[S: 2*S]
+p[S}
+    API ID.  See PEP 445.  This is a character, but seems undocumented.
+p[S+1: 2*S]
     Copies of FORBIDDENBYTE.  Used to catch under- writes and reads.
 p[2*S: 2*S+n]
     The requested memory, filled with copies of CLEANBYTE.