Re: Cocoa Documentation Updated for December Tools Release

FROM : Matt Rollefson
DATE : Mon Jan 14 21:39:32 2002

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_removed>
> << Et le chemin est long du projet ` la chose. >> Molihre, Tartuffe.
> _______________________________________________
> cocoa-dev mailing list | <email_removed>
> Help/Unsubscribe/Archives:
> http://www.lists.apple.com/mailman/listinfo/cocoa-dev
> Do not post admin requests to the list. They will be ignored.