Re: Xcode 3 doc window woes (was: Lost markers after Reference Library update)
Re: Xcode 3 doc window woes (was: Lost markers after Reference Library update)
- Subject: Re: Xcode 3 doc window woes (was: Lost markers after Reference Library update)
- From: Matt Neuburg <email@hidden>
- Date: Mon, 31 Dec 2007 15:36:32 -0800
- Thread-topic: Xcode 3 doc window woes (was: Lost markers after Reference Library update)
Hey, Ron - I really appreciate the extensive update. My own frustration is
twofold: (a) these things do seriously impede usability, and (b) many of
them are things where we've been told in the past that they were known and
would be fixed. But having the benefit of your time and attention on this
stuff is really good; communication alone is a major palliative.
That said, maybe there's a miscommunication here on how stuff show work.
Here's a clue: it should work *as in Safari*. Safari gets navigation right,
so why can't this doc window which is presumably using WebKit?
Let me just give a few quick responses to some of your responses:
>> * Option-double-clicking something in my code sometimes takes me to
>> the
>> wrong page. For example, option-double-clicking the class name
>> QTMovie
> This is not a bug in that we don't really know what "QTMovie" page you
> are after, since both the method and the class are valid
> destinations. Option-double-clicking simply does an API search for
> the text and displays the first location found among the results. In
> this case, both the QTMovie method and class are in the results, and
> the method happens to come up first. The class (in my testing) is the
> second item in the list.
Perhaps there could be a rule that the class should come up first in case
both a class and a method exist? This would cover a lot of these situations.
>> * Sometimes, option-double-clicking something in my code does
>> nothing. It
>> brings the docs page to the front but we don't switch content from
>> what's
>> already showing there.
>
> If you can provide a specific example in a bug report, that would be
> very helpful
Not easy, since it is not readily reproducible. I don't think it has
anything to do with the symbol; I think it has to do with some other aspect
of the doc-display mechanism. But I'll try to make a movie of it the next
time I see it.
>> * The bug where hitting the "back" button sometimes does not take
>> you to the
>> previously viewed page, but rather rockets you unexpectedly into
>> Safari, is
>> not fixed.
>
> This has been discussed multiple times previously, and we believe
> we've fixed it for a future release.
Right, but this is really hampering me, so naturally I was hoping it would
have been fixed for a *past* release. :)
>> * The bug where, if hitting the "back" button works, it does not
>> take you to
>> the particular area of the frameset that you were looking at before,
>> but
>> rather to the top of the first page of the frameset, is not fixed.
>
> This is one of the items actually fixed by our new TOC approach, and
> I'm unable to reproduce what you are reporting.
Okay, here's an example. Start in the AppKit Reference page (it's bookmarked
in the default Xcode doc window). Click NSActionCell. Click Instance Methods
on the left and click "target" on the left, to make the right side show the
info for the target method.
Now, to the right of that you'll see a "Next Page" link. Click it. Now go
Back. Instead of going back to "target" you're back on the Application Kit
Framework Reference page.
The same sequence done in Safari works perfectly (and in Xcode 2.3).
Incidentally, your "toc" is not working right either. In the AppKit
Reference page, click Introduction (right at the top). The whole page is
pushed over to the right as if there were a toc, and there is a Hide TOC
link, but there is no toc and clicking Hide TOC does nothing (beyond a kind
of flash).
Here's another example. Go to the Apple Help Programming Guide (do a title
search to help you find it). In the toc, click "authoring apple help". Still
in the toc, click "Indexing your help book". Now click any link within the
right frame area - it could be "Using the help indexer utility", or "Next
Page". Now go Back. You are not returned to the "Indexing your help book"
page where you just were - instead, you are rocketed out of the apple help
programming guide altogether.
Similary when I use the file history popup I expect to be returned to where
I was last in that document group (and this is how it works in Xcode 2.3).
Instead I am always returned to the first page of the document group.
m.
--
matt neuburg, phd = email@hidden, http://www.tidbits.com/matt/
pantes anthropoi tou eidenai oregontai phusei
Among the 2007 MacTech Top 25, http://tinyurl.com/2rh4pf
AppleScript: the Definitive Guide, http://tinyurl.com/2ouo3b
Take Control of Customizing Leopard, http://tinyurl.com/2t9629
TidBITS, Mac news and reviews since 1990, http://www.tidbits.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