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