Re: Doc access for Cocoa
Re: Doc access for Cocoa
- Subject: Re: Doc access for Cocoa
- From: Rainer Brockerhoff <email@hidden>
- Date: Sat, 10 Nov 2001 10:10:50 -0200
Date: Fri, 9 Nov 2001 16:04:28 -0800
From: Ronald Hayden <email@hidden>
I just joined this list, after hearing about some complaints related to
doc access for Cocoa. This is something we've been working hard on, and
there may be some features people are unaware of.
If you are using ProjectBuilder, try the following:
...
FIND
To find any particular piece of API, go to the PB Find panel, accessible
through the tab visible in the top half of your PB window.
In the area where you specify options for your search, set the lower
popup to Definitions. (This seems the most obscure part of things to
me, and I want to check with the PB folks to see if we could have any
kind of search work for doc.)
When you do the find, if you click on the text portion of the hit, you
are jumped to the header file at that API. If you click on the book
next to the hit, you are jumped to that location in the documentation.
As you'll see further down, the book is a consistent UI element meaning
"click this for doc".
One additional trick which took me a long time to find out: I use
quite a lot of BSD APIs and figured out that they can be included in
the search.
Go to Target -> Build Settings -> Search Paths and put the line
"/usr/includes" into the "Headers" section. Souds obvious after the
fact...
CLASS BROWSER
...
We are in the process right now of prioritizing what our next set of doc
access features should be. Feel free to post suggestions here or email
them to me.
The Class Browser is a great help. It would be even better if html
files in PB remembered the scrolling position when you return to
them, like source files do. Better cross-linking between docs would
also help; many references to a specific method in another class link
to the top of the document instead of to the proper method call.
--
Rainer Brockerhoff <email@hidden>
Belo Horizonte, Brazil
"Originality is the art of concealing your sources."
http://www.brockerhoff.net/ (updated Oct. 2001)