On 11/10/20 4:43 PM, Iain Sandoe wrote:
> Hi Jeff,
>
> Jeff Law <l...@redhat.com> wrote:
>>>
>>> This attribute allows pointers to be marked as pointers to
>>> an NSObject-compatible object.  This allows for additional
>
>>
>> OK with a suitable update to documentation.  I have no idea the
>> attribute is supposed to do.
>
> Joseph ack’d this and I applied it to master ..
>
> .. this was intentionally undocumented.
>
> I originally wrote documentation for it.  However, it turns out that it
> is undocumented in both clang (and as far as I can tell Apple’s)
> material.
>
> This is perhaps because it’s not really intended (or recommended)
> for end-user code, but for “internal” cases when writing libraries etc.
>
> WDYT? (I’m happy to ressurect the documentation I wrote and
> post/apply it).

Your call -- if users aren't supposed to use the attribute, then
documentation is much less important ;-)

Jeff


Reply via email to