This is the mail archive of the gcc-patches@gcc.gnu.org mailing list for the GCC project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

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


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


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]