On Nov 21, 2008, at 7:59 AM, Filip van der Meeren wrote:

Sorry to be this crude, but the documentation isn't created for beginners.

Sorry to be blunt, but some of it is. And Cocoa Fundamentals in particular is intended for newcomers to the platform and comparative newcomers to programming.

Whether for newcomers or not, though, the documentation should not be misleading or wrong. In this case, it's at least misleading (if for no other reason than that it encourages an unproductive line of thought).

I agree, but what would you have the documentation say ?

Per my previous reply, it should simply state that — in accordance with standard memory management rules, in a reference counted environment — the receiver does not own the returned object.

That accurately describes the situation in all cases, and doesn't encourage the reader to unnecesarily and unproductively start thinking about autorelease.

mmalc

_______________________________________________

Cocoa-dev mailing list (Cocoa-dev@lists.apple.com)

Please do not post admin requests or moderator comments to the list.
Contact the moderators at cocoa-dev-admins(at)lists.apple.com

Help/Unsubscribe/Update your Subscription:
http://lists.apple.com/mailman/options/cocoa-dev/archive%40mail-archive.com

This email sent to [EMAIL PROTECTED]

Reply via email to