[PATCH][docs] Re: Update __atomic builtins documentation.

Jeff Law law@redhat.com
Fri May 1 15:14:00 GMT 2015


On 04/30/2015 04:44 AM, Matthew Wahab wrote:
> [added tags to subject]
>
> Ping.
>
> On 20/04/15 14:29, Matthew Wahab wrote:
>> Hello,
>>
>> The documentation for the __atomic builtins isn't clear about their
>> expectations
>> and behaviour. In particular, assumptions about the C11/C++11
>> restrictions on
>> programs should be stated and the different behaviour of memory models
>> in fences
>> and in operations should be noted. The behaviour of compare-exchange
>> when the
>> compare fails is also confusing and the description of the
>> implementation of the
>> __atomics is mixed in with the description of their functionality.
>>
>> This patch tries to deal with some of these problems.
>>
>> Tested by looking at the html.
>>
>> Ok for trunk?
>> Matthew
>>
>> 2015-04-20  Matthew Wahab  <matthew.wahab@arm.com>
>>
>>     * doc/extend.texi (__atomic Builtins): Move implementation details
>>     to the end of the description, rewrite opening paragraphs, state
>>     difference with __sync builtins, state C11/C++11 assumptions,
>>     weaken itemized descriptions, add explanation of memory model
>>     behaviour, expand description of compare-exchange, simplify text.
OK.



jeff



More information about the Gcc-patches mailing list