Re: Cocoa Documentation on NSFormatter
Re: Cocoa Documentation on NSFormatter
- Subject: Re: Cocoa Documentation on NSFormatter
- From: Matt Rollefson <email@hidden>
- Date: Mon, 17 Dec 2001 12:24:28 -0800
On Sunday, December 16, 2001, at 01:28 AM, Thomas Lachand-Robert wrote:
Le samedi 15 dicembre 2001, ` 11:46 , Ondra Cada a icrit :
It is documented nicely and well.
Humm. I certainly wouldn't say that! I still consider that the chain of
itneraction between cells and formatters is not really explained.
Moreover,
since a formatter is primarily intented to format cells (ok it is not
requirement, but it is 99,99% of its use, no?), there should be at
least a note saying that objects returned by formatters ought to
implement NSCopying in that case.
Generally speaking, I feel that the doc need more 'transversal'
information, in particular for interactions between classes, like
Foundation and AppKit. Foundation can be used alone, but is certainly
very frequently used with AppKit, so more information here should be
useful.
Thanks for the feedback on the documentation. The type of use-case or
design documentation you mention is definitely lacking in places. We're
working at first completing the reference documentation, and then adding
in this type of information that explains how multiple different classes
interact to accomplish different tasks. We know we're not there yet, but
we're constantly working on improving the documentation.
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.
Matt Rollefson (Rollie)
Manager: Cocoa & Developer Tools
Technical Publications
Apple Computer, Inc.