Re: Documentation frustrations
Re: Documentation frustrations
- Subject: Re: Documentation frustrations
- From: Guy English <email@hidden>
- Date: Sat, 9 Jul 2005 02:23:19 -0400
On 7/9/05, Raffael Cavallaro <email@hidden> wrote:
> On Jul 9, 2005, at Sat, Jul 9, 1:32 48 AM, mmalcolm crawford wrote:
> > If you find places where you believe the API reference would
> > benefit from code samples, please file enhancement requests.
> I would have to file enhancement requests for most of the API
> references - sample code in the API references is as scarce as water
> in a desert.
I really believe that detailed sample code doesn't belong in the API
reference. It's a reference - it's not there to teach, it's there to
quickly give you the essentials of what you need to know about an
object or method. What could be helpful would be small links in the
method definitions to either tutorials that cover the class in depth
or sample code that uses the class in question.
> > And again it would be interesting if you could provide an outline
> > for the NSView drawRect: method.
> I don't follow you here - is this intended to be sarcastic because
> NSView is an abstract class?
Well, no, I think mmalc is making the point that a drawRect method for
a custom subview is going to be very specific to the view you're
trying to make ...
- (void) drawRect: (NSRect) rect
{
[[NSColor redColor] set];
NSRectFill( rect );
}
Doesn't help very much ...
Take care,
Guy
_______________________________________________
Do not post admin requests to the list. They will be ignored.
Cocoa-dev mailing list (email@hidden)
Help/Unsubscribe/Update your Subscription:
This email sent to email@hidden