Re: Using 3.1's documentation window
Re: Using 3.1's documentation window
- Subject: Re: Using 3.1's documentation window
- From: Thomas Davie <email@hidden>
- Date: Mon, 21 Sep 2009 21:52:19 +0200
On 21 Sep 2009, at 21:18, Brent Shank wrote:
Hi Tom,
On Sep 21, 2009, at 12:02 PM, Thomas Davie wrote:
I've been working with Xcode 3.2 for a couple of weeks now, and
overall am very very impressed with it, but it's documentation
window is a major step back.
Search results appear very very slowly,
This is unexpected. Does this reproduce for you consistently?
It does, it takes ~1-2 seconds for results to appear at all, but more
importantly 5-6 seconds for results from matching the name of the API
to appear. This is especially annoying as I seldom care about
anything other than the API matches. Previously, searching for cocoa
classes yielded near instant results.
often in the wrong order.
Please elaborate. You can sort the API search results using the
contextual menu. By default, they're sorted in alphabetical order.
A good example is searching for NSArray, gives back expandTabRunsArray
as it's first result.
The search results area gives less details about what it's found,
and it's highly unpredictable if you try to start reading something
before a search has finished.
What details do you miss? The new doc window in Xcode 3.2 reflects
user feedback we've received over the years that the content area in
the doc window was too small. Providing more space for the content
required simplifying the search results UI. In general, that change
has been very positively received.
The lack of a language column, and a documentation set column is a
fairly minor annoyance to me amongst the other problems, the slow
search, and unpredictable behavior until the search is finished are
the two biggest problems I'm seeing. A particular example of which
that I experienced recently, in searching for "objective-c 2.0" to
find the runtime documentation, I saw it flash up in the left hand
column, clicked on it, and got quickly to the documentation. Only for
the search to complete, for some reason, the near exact match to fall
off the bottom of the list on the left, and the documentation to
switch to the documentation for stl_alloc.h, because somewhere in the
middle of the document it mentions the word "object".
Hope that clarifies some of the problems I've been hitting.
Thanks
Tom Davie
_______________________________________________
Do not post admin requests to the list. They will be ignored.
Xcode-users mailing list (email@hidden)
Help/Unsubscribe/Update your Subscription:
This email sent to email@hidden