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: Ronald Hayden <email@hidden>
- Date: Fri, 2 Jun 2006 10:18:07 -0700
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.
This is definitely a challenge whenever "scraping" HTML for
information. We're committed to continually improving the appearance
and usefulness of the HTML for our reference (if you compare our HTML
from a few years ago to the HTML today, you'll see a night and day
difference in readability, IMO), so we can't guarantee that it will
freeze at any particular point.
However, we are working on some ways to provide more regular and
predictable access to the reference HTML in the future.
-- Ron
On Jun 2, 2006, at 9:18 AM, Shamyl Zakariya wrote:
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