why are there zero examples in the cocoa docs?!

FROM : Joeles Baker
DATE : Sat Jan 19 20:47:57 2008

Hi,

or in other words:
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

Discussion
Each array element is an NSDictionary containing key-value pairs. 
Currently two keys are defined for this dictionary, 
QTMovieChapterNameand QTMovieChapterStartTime. The value for the 
QTMovieChapterName key is an NSString object that is the chapter name. 
The value for the QTMovieChapterStartTime key is an NSValue object 
that wraps a QTTime structure that indicates the start time of the 
chapter. The receiving QTMovie object must be editable or an exception 
will be raised.

The attributes dictionary specifies additional attributes for the 
chapters. Currently only one key is recognized for this dictionary, 
QTMovieChapterTargetTrackAttribute, which specifies the QTTrack in the 
receiver that is the target of the chapters; if none is specified, 
this method uses first video track in movie. If no video track is in 
the movie, this method uses the first audio track in the movie. If no 
audio track is in the movie, this method uses the first track in the 
movie. If an error occurs and errorPtr is non-NULL, then an NSError 
object is returned in that location.



yeah..... cool.... what?


so probably i have to call something like:

[myMovie addChapters:myChapterArray]

but i have really no idea how that chapterarray should look like :-/

looking forward for the "initial hint" that will hopefully light the 
spark :-)

best,

--Joeles