Re: Trying to understand -- please help...
Re: Trying to understand -- please help...
- Subject: Re: Trying to understand -- please help...
- From: "I. Savant" <email@hidden>
- Date: Wed, 21 May 2008 15:00:52 -0400
> 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 (email@hidden)
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:
This email sent to email@hidden