Re: ADC Reference Library is not optimized for Mac OS X?
Re: ADC Reference Library is not optimized for Mac OS X?
- Subject: Re: ADC Reference Library is not optimized for Mac OS X?
- From: Shamyl Zakariya <email@hidden>
- Date: Fri, 2 Jun 2006 12:18:50 -0400
We're also working on some improved ways to display doc
information quickly.
May I recommend taking a look at Cocoa Browser? Instead of breaking
up documentation into billions and billions of tiny html files, it
parses the html and uses a clean NSBrowser based approach to provide
a clean view of it all. Plus it make is easy to browse documentation,
which is something the built-in xcode documentation app fails at.
http://www.macupdate.com/info.php/id/10291
It's basically just a better approach at a documentation browser. The
thing is, every update to Xcode documentation breaks its parser
because it seems every time Xcode is updated something subtle about
the documentation formatting changes. Sadly, Cocoa Browser is so
useful that I always feel like my hands are tied behind my back when
I can't use it. In the past I've submitted patches to fix the
parsing, but frankly, it's infuriating to keep up when it ends up
breaking a few times a year.
email@hidden
"yeah, well, that's just like your *opinion*, man."
-- the Dude
On Jun 1, 2006, at 2:58 PM, Ronald Hayden wrote:
Couldn't it be possible to break this document into one HTML
document per function?
We regularly iterate on the best approach for displaying the
documentation, and are interested in input on this. In the case of
the File Manager, which is perhaps our worst case scenario, I
believe we will be breaking that reference into multiple reference
documents and the situation should improve in the near future.
Anytime you find a particular doc page to be problematic, please do
use the feedback links at the bottom of the page. We process all
feedback quickly, and it goes into our system in a way that let's
us track how people are responding to particular documents, etc.
We're also working on some improved ways to display doc information
quickly.
-- Ron
On Jun 1, 2006, at 11:42 AM, Stéphane Sudre wrote:
Task
----
Find Carbon Function documentation in XCode using the Alt + Double-
click solution.
Configuration
-------------
PowerMac G5 Quad + 5GB RAM + Mac OS X 10.4.6 + XCode 2.3
Time to show some FSRef related Carbon function documentation
-------------------------------------------------------------
5-10 seconds
Question/Suggestion
-------------------
Couldn't it be possible to optimize the whole ADC Reference
Library so that you don't have the feeling you're using a slower
machine than a Mac LC? I mean, Think Reference on a LC seems so
fast sometimes compared to the current XCode solution on a
PowerMac G5 Quad.
For instance, all the FSRef related function documentation is
contained in one HUGE HTML document (equivalent of http://
developer.apple.com/documentation/Carbon/Reference/File_Manager/
Reference/reference.html#//apple_ref/doc/uid/TP30000107-CH1g-
F00140). Couldn't it be possible to break this document into one
HTML document per function?
_______________________________________________
Do not post admin requests to the list. They will be ignored.
Xcode-users mailing list (email@hidden)
Help/Unsubscribe/Update your Subscription:
40apple.com
This email sent to email@hidden
_______________________________________________
Do not post admin requests to the list. They will be ignored.
Xcode-users mailing list (email@hidden)
Help/Unsubscribe/Update your Subscription:
40zakariya.net
This email sent to email@hidden
_______________________________________________
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