> Pretty soon, the documentation is going to be 80% repetition and 20% actual > unique-to-the-class content.
<snip> > I understand the frustration initially experienced by reading, say, the docs > to NSArray and not having every last detail spelled out. At the same time, > most of the details are not NSArray specific and the sooner the programmer > learns that, the more productive they will be! To be fair, Johnny has a point. This is an area where the documentation definitely needs to be consistent. Some convenience / factory methods *do* specifically state they return an autoreleased instance, but this one apparently does not. I was a bit shocked by that. I don't consider that repetition, merely specification. -- I.S. _______________________________________________ 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]