[Python-checkins] r80724 - in python/branches/py3k: Include/Python.h Include/dynamic_annotations.h Include/pyatomic.h Include/pystate.h Makefile.pre.in Objects/dictobject.c PC/VS7.1/pythoncore.vcproj PC/VS8.0/pythoncore.vcproj PC/os2emx/Makefile

[Jeffrey Yasskin]

On Thu, May 6, 2010 at 9:51 AM, A.M. Kuchling <amk at amk.ca> wrote:
> On Mon, May 03, 2010 at 09:29:35PM +0200, jeffrey.yasskin wrote:
>> I've implemented part of the C1x atomic types so that we can explicitly mark
>> variables that are used across threads, and get defined behavior as compilers
>> advance.
>>
>> I've added tsan's client header and implementation to the codebase in
>> dynamic_annotations.{h,c} (docs at
>> http://code.google.com/p/data-race-test/wiki/DynamicAnnotations).
>
> Do we need to describe any of this in the c-api documentation (even if
> only by reference to the ISO draft spec and to that wiki page)?

I'm not sure. I mostly intended it for people working on the
interpreter itself, which is why I made everything start with _Py_,
and internal interfaces don't usually go in the c-api docs. The new
functions could be useful for people trying to make their extensions
thread-safe though. If people think they will be, I can rename them to
Py_ and try to explain how to use them for extension development in
the c-api docs. I'm somewhat inclined to wait until an extension
author asks for them though, so they can beta-test my instructions.

Jeffrey