• Open Menu Close Menu
  • Apple
  • Shopping Bag
  • Apple
  • Mac
  • iPad
  • iPhone
  • Watch
  • TV
  • Music
  • Support
  • Search apple.com
  • Shopping Bag

Lists

Open Menu Close Menu
  • Terms and Conditions
  • Lists hosted on this site
  • Email the Postmaster
  • Tips for posting to public mailing lists
Re: why are there zero examples in the cocoa docs?!
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: why are there zero examples in the cocoa docs?!


  • Subject: Re: why are there zero examples in the cocoa docs?!
  • From: mmalc crawford <email@hidden>
  • Date: Sun, 20 Jan 2008 09:32:27 -0800


On Jan 19, 2008, at 11:47 AM, Joeles Baker wrote:

why does the documentation suck so much (for beginners)? :-)
am i researching the wrong place?
when looking at for example the php documentation, every method has at least a nice syntax sample...
when reading the cocoa doc, i have something like this:
addChapters
Adds chapters to the receiver using the information specified in the chapters array.
- (void)addChapters:(NSArray *)chapters withAttributes:(NSDictionary *)attributes error:(NSError **)errorPtr


Another aspect to this is that QTKit is not a "core" Cocoa framework. There are likely to be fewer examples of *basic* techniques than in, say, Foundation or AppKit.

The subject line notwithstanding, there *are* many examples in the documentation -- even in the API reference. One of the most extreme examples perhaps is given in NSMutableArray:
<http://developer.apple.com/documentation/Cocoa/Reference/Foundation/Classes/NSMutableArray_Class/Reference/Reference.html#//apple_ref/occ/instm/NSMutableArray/insertObjects:atIndexes: >


mmalc

_______________________________________________

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


  • Follow-Ups:
    • Re: why are there zero examples in the cocoa docs?!
      • From: Tom Davies <email@hidden>
References: 
 >why are there zero examples in the cocoa docs?! (From: Joeles Baker <email@hidden>)

  • Prev by Date: TableView::setDoubleAction's action always responding even editable items
  • Next by Date: How to rename a filename in uppercase
  • Previous by thread: Re: why are there zero examples in the cocoa docs?!
  • Next by thread: Re: why are there zero examples in the cocoa docs?!
  • Index(es):
    • Date
    • Thread