Returns `Retained` objects for methods documented with "The caller assumes no ownership of the returned value and should not CFRelease it."

[ColinFinck]

AVCaptureDeviceFormat has two methods mediaType and formatDescription that are both documented with:

The caller assumes no ownership of the returned value and should not CFRelease it.

However, both methods also return Retained objects, which implement a Drop handler that calls objc_release_fast.

This gives the impression that memory is being released here when it shouldn't.

[madsmtm]

Yeah, we're not really that much in control over the docs here, and it'd be wayy too much work for me to write these docs manually. Though I guess we could perhaps detect common sentences like these and strip them out? Maybe you could figure out a list of common sentences / some regexes to match against? Then I'd be glad to code it up.

A good rule of thumb is "objc2 will take care of it for you", maybe we could document that part better?

(If it's any consolation, Swift somewhat has the same documentation issue here).

[ColinFinck]

I was wondering: Is just the documentation wrong here or are the mediaType and formatDescription methods wrong in returning a Retained object?