While I'm on the subject of documentation, here are a couple of tricks
that I've found useful.
Just before each call to a Cocoa method, I add a comment that gives the
method's location in the Cocoa Browser:
# Found. > Classes > NSNotificationCenter > Class Methods >
# defaultCenter
#
my $dnc = NSNotificationCenter->defaultCenter();
# AppKit > Classes > NSTableView > Instance Methods >
# setRowHeight
#
$self->{$view}->setRowHeight($height);
At the beginning of each method that is being called from Cocoa, I
put in the Cocoa Browser location and text, along with a prototype:
# browser_numberOfRowsInColumn
#
# Application Kit > Classes > NSNrowser >
# Methods Implemented by the Delegate > browser:numberOfRowsInColumn:
#
# browser:numberOfRowsInColumn:
#
# - (int)browser:(NSBrowser *)sender
# numberOfRowsInColumn:(int)column
#
# Returns the number of rows of data in the column at index column.
# Either this method or browser:createRowsForColumn:inMatrix: must
# be implemented, but not both.
#
# See Also: - browser:willDisplayCell:atRow:column:
$OBJC_EXPORT{'browser:numberOfRowsInColumn:'} = {
'args' => '@i',
'return' => 'i',
};
sub browser_numberOfRowsInColumn {
my ($self, $browser, $column) = @_;
...
-r
--
email: [EMAIL PROTECTED]; phone: +1 650-873-7841
http://www.cfcl.com/rdm - my home page, resume, etc.
http://www.cfcl.com/Meta - The FreeBSD Browser, Meta Project, etc.
http://www.ptf.com/dossier - Prime Time Freeware's DOSSIER series
http://www.ptf.com/tdc - Prime Time Freeware's Darwin Collection
