• 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: Using 3.1's documentation window
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Using 3.1's documentation window


  • Subject: Re: Using 3.1's documentation window
  • From: "email@hidden" <email@hidden>
  • Date: Mon, 21 Sep 2009 21:38:47 +0100


On 21 Sep 2009, at 20:52, Thomas Davie wrote:


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.
Thomas

I don't see this behaviour. Searching for NSArray yields NSArray as the top hit.
As for expandTabRunsArray, I cannot find it at all.


In general I find the help better, quicker and a lot less prone to expiring.
Sounds like your help installation needs help.
Did you uninstall 3.1 before upgrading?



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

Jonathan Mitchell

Developer
http://www.mugginsoft.com





_______________________________________________
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


  • Follow-Ups:
    • Re: Using 3.1's documentation window
      • From: Andy Lee <email@hidden>
References: 
 >Using 3.1's documentation window (From: Thomas Davie <email@hidden>)
 >Re: Using 3.1's documentation window (From: Brent Shank <email@hidden>)
 >Re: Using 3.1's documentation window (From: Thomas Davie <email@hidden>)

  • Prev by Date: Re: Replacement for CW Re-search for files
  • Next by Date: Re: Replacement for CW Re-search for files
  • Previous by thread: Re: Using 3.1's documentation window
  • Next by thread: Re: Using 3.1's documentation window
  • Index(es):
    • Date
    • Thread