r209231 - Update AttributeReference.rst.
Peter Collingbourne
peter at pcc.me.uk
Tue May 20 12:46:22 PDT 2014
OK, reverted in r209232.
Peter
On Tue, May 20, 2014 at 03:41:08PM -0400, Aaron Ballman wrote:
> This should no longer be required, and in fact, I would prefer this
> change be reverted. We are automatically generating this RST file on
> the server on a daily basis, and your recent updates to attribute
> documentation were a good test to ensure everything is working as
> expected. I was intending to check the website in the morning after I
> received the automated status response from the server. If the server
> is updated properly, I intend to change the contents of this file to
> note that it no longer needs to be updated manually since the server
> will overwrite it, and make a note on the lists.
>
> Sorry that I didn't warn you about this earlier!
>
> ~Aaron
>
> On Tue, May 20, 2014 at 3:27 PM, Peter Collingbourne <peter at pcc.me.uk> wrote:
> > Author: pcc
> > Date: Tue May 20 14:27:39 2014
> > New Revision: 209231
> >
> > URL: http://llvm.org/viewvc/llvm-project?rev=209231&view=rev
> > Log:
> > Update AttributeReference.rst.
> >
> > Modified:
> > cfe/trunk/docs/AttributeReference.rst
> >
> > Modified: cfe/trunk/docs/AttributeReference.rst
> > URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/docs/AttributeReference.rst?rev=209231&r1=209230&r2=209231&view=diff
> > ==============================================================================
> > --- cfe/trunk/docs/AttributeReference.rst (original)
> > +++ cfe/trunk/docs/AttributeReference.rst Tue May 20 14:27:39 2014
> > @@ -219,14 +219,14 @@ carries_dependency
> > The ``carries_dependency`` attribute specifies dependency propagation into and
> > out of functions.
> >
> > -When specified on a function or Objective-C method, the ``carries_depedency``
> > +When specified on a function or Objective-C method, the ``carries_dependency``
> > attribute means that the return value carries a dependency out of the function,
> > so that the implementation need not constrain ordering upon return from that
> > function. Implementations of the function and its caller may choose to preserve
> > dependencies instead of emitting memory ordering instructions such as fences.
> >
> > Note, this attribute does not change the meaning of the program, but may result
> > -in generatation of more efficient code.
> > +in generation of more efficient code.
> >
> >
> > enable_if
> > @@ -312,6 +312,18 @@ not ODR-equivalent.
> > Query for this feature with ``__has_attribute(enable_if)``.
> >
> >
> > +flatten (gnu::flatten)
> > +----------------------
> > +.. csv-table:: Supported Syntaxes
> > + :header: "GNU", "C++11", "__declspec", "Keyword"
> > +
> > + "X","X","",""
> > +
> > +The ``flatten`` attribute causes calls within the attributed function to
> > +be inlined unless it is impossible to do so, for example if the body of the
> > +callee is unavailable or if the callee has the ``noinline`` attribute.
> > +
> > +
> > format (gnu::format)
> > --------------------
> > .. csv-table:: Supported Syntaxes
> > @@ -467,6 +479,18 @@ not be inserted by ThreadSanitizer. The
> > tool to avoid false positives and provide meaningful stack traces.
> >
> >
> > +no_split_stack (gnu::no_split_stack)
> > +------------------------------------
> > +.. csv-table:: Supported Syntaxes
> > + :header: "GNU", "C++11", "__declspec", "Keyword"
> > +
> > + "X","X","",""
> > +
> > +The ``no_split_stack`` attribute disables the emission of the split stack
> > +preamble for a particular function. It has no effect if ``-fsplit-stack``
> > +is not specified.
> > +
> > +
> > objc_method_family
> > ------------------
> > .. csv-table:: Supported Syntaxes
> > @@ -545,6 +569,24 @@ implementation of an override in a subcl
> > ^
> >
> >
> > +optnone (clang::optnone)
> > +------------------------
> > +.. csv-table:: Supported Syntaxes
> > + :header: "GNU", "C++11", "__declspec", "Keyword"
> > +
> > + "X","X","",""
> > +
> > +The ``optnone`` attribute suppresses essentially all optimizations
> > +on a function or method, regardless of the optimization level applied to
> > +the compilation unit as a whole. This is particularly useful when you
> > +need to debug a particular function, but it is infeasible to build the
> > +entire application without optimization. Avoiding optimization on the
> > +specified function can improve the quality of the debugging information
> > +for that function.
> > +
> > +This attribute is incompatible with the ``always_inline`` attribute.
> > +
> > +
> > overloadable
> > ------------
> > .. csv-table:: Supported Syntaxes
> > @@ -632,6 +674,18 @@ caveats to this use of name mangling:
> > Query for this feature with ``__has_extension(attribute_overloadable)``.
> >
> >
> > +pcs (gnu::pcs)
> > +--------------
> > +.. csv-table:: Supported Syntaxes
> > + :header: "GNU", "C++11", "__declspec", "Keyword"
> > +
> > + "X","X","",""
> > +
> > +On ARM targets, this can attribute can be used to select calling conventions,
> > +similar to ``stdcall`` on x86. Valid parameter values are "aapcs" and
> > +"aapcs-vfp".
> > +
> > +
> > release_capability (release_shared_capability, clang::release_capability, clang::release_shared_capability)
> > -----------------------------------------------------------------------------------------------------------
> > .. csv-table:: Supported Syntaxes
> > @@ -677,6 +731,26 @@ model to use. It accepts the following s
> > TLS models are mutually exclusive.
> >
> >
> > +thread
> > +------
> > +.. csv-table:: Supported Syntaxes
> > + :header: "GNU", "C++11", "__declspec", "Keyword"
> > +
> > + "","","X",""
> > +
> > +The ``__declspec(thread)`` attribute declares a variable with thread local
> > +storage. It is available under the ``-fms-extensions`` flag for MSVC
> > +compatibility. Documentation for the Visual C++ attribute is available on MSDN_.
> > +
> > +.. _MSDN: http://msdn.microsoft.com/en-us/library/9w1sdazb.aspx
> > +
> > +In Clang, ``__declspec(thread)`` is generally equivalent in functionality to the
> > +GNU ``__thread`` keyword. The variable must not have a destructor and must have
> > +a constant initializer, if any. The attribute only applies to variables
> > +declared with static storage duration, such as globals, class static data
> > +members, and static locals.
> > +
> > +
> > Type Attributes
> > ===============
> >
> >
> >
> > _______________________________________________
> > cfe-commits mailing list
> > cfe-commits at cs.uiuc.edu
> > http://lists.cs.uiuc.edu/mailman/listinfo/cfe-commits
>
--
Peter
More information about the cfe-commits
mailing list