From df099f5df672c6f431dcf7ef276c462bebc13919 Mon Sep 17 00:00:00 2001 From: Tim Peters Date: Thu, 19 Sep 2013 21:06:37 -0500 Subject: [PATCH] Update internal comments to say _something_ about the "API ID". Best I can tell, the possible values for this aren't documented anywhere. --- 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 index f869e7c05e6..646ac2344cb 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 db774b8423f..2ab66a33b92 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.