[PATCH] Add AttrDocs for objc_boxable attribute

[AlexDenisov]

Thank you for the corrections.
Natural language is not my cup of tea.

-------------- next part --------------
A non-text attachment was scrubbed...
Name: objc_boxable_attr_docs.patch
Type: application/octet-stream
Size: 1539 bytes
Desc: not available
URL: <http://lists.llvm.org/pipermail/cfe-commits/attachments/20150723/8d93949c/attachment.obj>
-------------- next part --------------



> On 23 Jul 2015, at 22:57, John McCall <rjmccall at apple.com> wrote:
> 
>> On Jul 23, 2015, at 1:20 PM, AlexDenisov <1101.debian at gmail.com> wrote:
>> Patch adds rough documentation for objc_boxable attribute
> 
> +def ObjCBoxableDocs : Documentation {
> +    let Category = DocCatType;
> +    let Content = [{
> +Structs and unions marked with ``objc_boxable`` attribute can be used inside of boxed expressions.
> 
> “Structs and unions marked with the ``objc_boxable`` attribute can be used with the Objective-C boxed expression syntax, ``@(…)``.”
> 
> +**Usage**: ``__attribute__((objc_boxable))``.  This attribute
> +can only be placed at record declaration or record definition:
> 
> This should be a separate paragraph; just add an empty line before **Usage**.
> 
> “This attribute can only be placed on a declaration of a trivially-copyable struct or union:”
> 
> +
> +.. code-block:: objc
> +
> +  struct __attribute__((objc_boxable)) some_struct {
> +    int i;
> +  };
> +  union __attribute__((objc_boxable)) some_union {
> +    int i;
> +    float f;
> +  };
> +  typedef struct __attribute__((objc_boxable)) _some_struct some_struct;
> +
> +  // ...
> +
> +  some_struct ss;
> +  NSValue *boxed = @(ss);
> 
> John.

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 496 bytes
Desc: Message signed with OpenPGP using GPGMail
URL: <http://lists.llvm.org/pipermail/cfe-commits/attachments/20150723/8d93949c/attachment.sig>