[Python-checkins] cpython: Update internal comments to say _something_ about the "API ID".

[tim.peters]

http://hg.python.org/cpython/rev/84658272e923
changeset:   85757:84658272e923
user:        Tim Peters <tim at python.org>
date:        Thu Sep 19 21:06:37 2013 -0500
summary:
  Update internal comments to say _something_ about the "API ID".

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

files:
  Misc/SpecialBuilds.txt |  4 +++-
  Objects/obmalloc.c     |  4 +++-
  2 files changed, 6 insertions(+), 2 deletions(-)


diff --git a/Misc/SpecialBuilds.txt b/Misc/SpecialBuilds.txt
--- a/Misc/SpecialBuilds.txt
+++ b/Misc/SpecialBuilds.txt
@@ -105,7 +105,9 @@
 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
--- a/Objects/obmalloc.c
+++ b/Objects/obmalloc.c
@@ -1702,7 +1702,9 @@
 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.

-- 
Repository URL: http://hg.python.org/cpython