Re: Uncaught exceptions thrown by Cocoa documented anywhere?
Re: Uncaught exceptions thrown by Cocoa documented anywhere?
- Subject: Re: Uncaught exceptions thrown by Cocoa documented anywhere?
- From: James Hober <email@hidden>
- Date: Wed, 13 Feb 2008 13:56:26 -0800
On Feb 13, 2008, at 11:49 AM, Adam P Jenkins wrote:
On Feb 13, 2008, at 2:27 PM, James Hober wrote:
I imagine I'm not the only one who would like to know when Cocoa
throws an uncaught exception. Are they documented anywhere?
Not consistently. Some methods are documented as throwing exceptions,
and others aren't. Similarly, some method documentation specifies
what the error return value would be, and others don't specify
anything about error handling.
I find Apple's documentation particularly bad in this regard, compared
to say the documentation for the Java, Python, C, or C++ standard
libraries, and other proprietary libraries like MFC or QT. Overall I
think Cocoa is impressive, but the documentation leaves a lot to be
desired, at least as far as being consistent and well organized.
Well, I did the feedback at the bottom of the documentation pages. I
asked for the two exceptions I encountered to be documented. And I
asked for uncaught exceptions that Cocoa throws to be documented in
general.
I mostly like Apple's documentation. Although one other thing snares
me: Sometimes I just want to know the simple way to do something.
Other times I want technical details. It would be nice if these
could be separated a little better.
James
_______________________________________________
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