r175838 - Added a footnote to the documentation for objc_storeStrong that makes it clear

Michael Gottesman mgottesman at apple.com
Thu Feb 21 16:16:49 PST 2013


Author: mgottesman
Date: Thu Feb 21 18:16:48 2013
New Revision: 175838

URL: http://llvm.org/viewvc/llvm-project?rev=175838&view=rev
Log:
Added a footnote to the documentation for objc_storeStrong that makes it clear
that a __strong object of block type is a valid argument to objc_storeStrong but
that an objc_retain and not an objc_retainBlock will be emitted.

Modified:
    cfe/trunk/docs/AutomaticReferenceCounting.rst

Modified: cfe/trunk/docs/AutomaticReferenceCounting.rst
URL: http://llvm.org/viewvc/llvm-project/cfe/trunk/docs/AutomaticReferenceCounting.rst?rev=175838&r1=175837&r2=175838&view=diff
==============================================================================
--- cfe/trunk/docs/AutomaticReferenceCounting.rst (original)
+++ cfe/trunk/docs/AutomaticReferenceCounting.rst Thu Feb 21 18:16:48 2013
@@ -2068,7 +2068,7 @@ adequately aligned for a pointer.  ``val
 object.
 
 Performs the complete sequence for assigning to a ``__strong`` object of
-non-block type.  Equivalent to the following code:
+non-block type [*]_.  Equivalent to the following code:
 
 .. code-block:: objc
 
@@ -2082,6 +2082,11 @@ non-block type.  Equivalent to the follo
 
 Always returns ``value``.
 
+.. [*] This does not imply that a ``__strong`` object of block type is an
+   invalid argument to this function. Rather it implies that an ``objc_retain``
+   and not an ``objc_retainBlock`` operation will be emitted if the argument is
+   a block.
+
 .. _arc.runtime.objc_storeWeak:
 
 ``id objc_storeWeak(id *object, id value);``





More information about the cfe-commits mailing list