• 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: from symbol name to full documentation in Xcode 4
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: from symbol name to full documentation in Xcode 4


  • Subject: Re: from symbol name to full documentation in Xcode 4
  • From: Christiaan Hofman <email@hidden>
  • Date: Fri, 18 Mar 2011 23:31:52 +0100

On Mar 18, 2011, at 17:08, Matt Neuburg wrote:

>
> On Mar 18, 2011, at 8:55 AM, Dave Camp wrote:
>
>> In Xcode 3.x, you just command double click a symbol and you go straight to the full documentation. There are no popups and no intermediate views. It was nice and direct
>
> Yeah, that's what I'm talking about. (Didn't realize you could omit Option; that must have been a left-over habit from Xcode 2.) What I'm asking is how to do exactly that in Xcode 4. I take it, though, that the answer is it can't be done.
>
> What angers me is that Xcode so obviously *could* do this. The underlining shows that it knows *where* the symbol is. The fact that it displays the correct info in Quick Help shows that it knows *what* the symbol is. The fact that you can click in Quick Help to jump right to the correct API shows that it knows where the full documentation on this symbol is. But it won't take you directly from the symbol to the full documentation on it. m.
>
> --
> matt neuburg, phd = email@hidden, http://www.apeth.net/matt/
> pantes anthropoi tou eidenai oregontai phusei
> Among the 2007 MacTech Top 25, http://tinyurl.com/2rh4pf
> Programming iOS 4! http://www.apeth.net/matt/default.html#iosbook
> RubyFrontier! http://www.apeth.com/RubyFrontierDocs/default.html
> TidBITS, Mac news and reviews since 1990, http://www.tidbits.com
>


Actually, this is NOT what I see (in Xcode 3.x!). Command-double-click brings me to the definition, not to the docs.

But let me defend Apple's choices, because I think it makes sense. The change I see between Xcode 3 and 4 is that for single modifiers they replaced the double-click by simply showing a link and allowing a single click. This is generally a very big improvement: 1. it is intuitive, because you see the link, so it's very easy to discover by accident (pressing a modifier and two clicks is very far from discoverable), 2. it requires one click less. However this is slightly different for the Option-Command modifier: instead of showing the docs, it shows the definition in the Assistant mode. Apparently they thought that made more sense, because it (Assistant) is a feature that is present in Xcode 4 and wasn't in Xcode 3, and moreover getting to the docs is just one click extra away (in Quick Help). So maybe it's not to your liking, but it does make sense.

However, I would like to add/admit that they could have easily improved the situation by providing the direct link to the docs without the intermediate popup, for instance using Shift-Option or some other unused modifier combo. Perhaps if we all ask for it they might add it in 4.1.

Christiaan

 _______________________________________________
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

References: 
 >from symbol name to full documentation in Xcode 4 (From: Matt Neuburg <email@hidden>)
 >Re: from symbol name to full documentation in Xcode 4 (From: Christiaan Hofman <email@hidden>)
 >Re: from symbol name to full documentation in Xcode 4 (From: Matt Neuburg <email@hidden>)
 >Re: from symbol name to full documentation in Xcode 4 (From: Christiaan Hofman <email@hidden>)
 >Re: from symbol name to full documentation in Xcode 4 (From: Matt Neuburg <email@hidden>)
 >Re: from symbol name to full documentation in Xcode 4 (From: Christiaan Hofman <email@hidden>)
 >Re: from symbol name to full documentation in Xcode 4 (From: Dave Camp <email@hidden>)
 >Re: from symbol name to full documentation in Xcode 4 (From: Matt Neuburg <email@hidden>)

  • Prev by Date: Re: from symbol name to full documentation in Xcode 4
  • Next by Date: Re: from symbol name to full documentation in Xcode 4
  • Previous by thread: Re: from symbol name to full documentation in Xcode 4
  • Next by thread: Re: from symbol name to full documentation in Xcode 4
  • Index(es):
    • Date
    • Thread