Re: Cocoa Documentation Updated for December Tools Release
Re: Cocoa Documentation Updated for December Tools Release
- Subject: Re: Cocoa Documentation Updated for December Tools Release
- From: Matt Rollefson <email@hidden>
- Date: Mon, 14 Jan 2002 12:39:32 -0800
File bugs with OS X (although in the tree at Apple there is a
Documentation (developer)/X component, if you can't find it they should
be shuffled by the DTS engineer). As to the specific bug, we're well
aware that the sheet documentation is inaccurate and inadequate, and are
working to address it. We should have the inaccuracies addressed soon,
the inadequacies a bit later. In our defense, the Cocoa implementation
of sheets changed at the last minute, so this documentation used to be
correct. Not in our defense, that was a long time ago... Thanks for the
report; we're working on it.
Matt Rollefson (Rollie)
Manager: Cocoa & Developer Tools
Technical Publications
On Sunday, January 6, 2002, at 05:03 AM, Thomas Lachand-Robert wrote:
Le dimanche 6 janvier 2002, ` 01:30 , Finlay Dobbie a icrit :
On Sunday, January 6, 2002, at 12:22 pm, Thomas Lachand-Robert wrote:
Is it ok to send documentation bugs directly to you? There is
apparently no place for that in bugreport.
Huh? Just file a radar under the OS X component, and it will be
assigned to the developer tools documentation group.
-- Finlay
Hm. I hope so! But it is jsut strange that there is no specific place
for the documentation. Also none of the items in the "nature of the
bug" popup seems convenient. Anyway for the current case I will use
"other bug" and type something explicit for the subject, and "not
applicable" for the severity. (Actually this last case has not been
intended to be used: it appears as "(2) No Workaround" in the bug
listing after submission!)
The documentation of NSBeginAlertSheet is the worse I have ever read
(even at Apple), full of mistakes: incorrect names for the parameters,
incorrect description, wrong declaration for sheetDidEnd and
sheetDidDismiss (as functions, though these are methods), and it
indicates DefaultReturn, etc.
, for return codes, though they are NSAlertDefaultReturn, etc.! That's
a lot of errors for a ten lines description!
Thomas Lachand-Robert
********************** email@hidden
<< Et le chemin est long du projet ` la chose. >> Molihre, Tartuffe.
_______________________________________________
cocoa-dev mailing list | email@hidden
Help/Unsubscribe/Archives:
http://www.lists.apple.com/mailman/listinfo/cocoa-dev
Do not post admin requests to the list. They will be ignored.