Re: Application name
Re: Application name
- Subject: Re: Application name
- From: Raymond Fischer <email@hidden>
- Date: Mon, 11 Nov 2002 12:08:44 -0800
On Friday, November 8, 2002, at 02:42 PM, Bill Cheeseman wrote:
on 02-11-08 1:52 PM, Raymond Fischer at email@hidden wrote:
does everybody else find that searching
the documentation on developer.apple.com to be a pointless
exercise?
That's a pretty broad statement. I haven't had a lot of trouble -- I
seem to
find what I need.
Yes, it was too broad. I'll give a specific example: Search for
"Application name" in the Carbon docs using an advanced search to
specify
only Carbon docs and matching all keywords. Result? 1820 matches.
Dozens, if not hundreds are sample code, and not just any sample code
but the very same sample code that has multiple paths to it.
Fine. I do some digging and I find the call I need: CopyProcessName.
Do a search on that and I get only four hits and it's clear which
one is the one I need. Except that it doesn't tell me anything
useful. Only the function definition is provided and a comment that
it is "Under evaluation for Carbon (not currently available)."
So I search through the header files to see what they say. Only
then do I find a clear description of what exactly the function
does and that it is available in CarbonLib 1.5 and later and
OS X 10.0 and later.
So _again_ I've wasted time looking at Apple's developer documentation
trying to find something that isn't even there and, in this case,
turns out to be wrong. Or rather, the documentation disagrees with
the header and I have to guess which I'll believe.
In short, using the search function on the web page is a waste of
time and even when I do know what I'm looking for I'm not at all
sure that I will find it.
Just to try to keep this on-topic, in particular I'm pretty confident
that
I've found all the accessibility documentation.
It's among the better, even though it's still incomplete. The
descriptions
of the various roles and attributes are rather brief. Something
describing
the higher-level semantics would be nice.
----
Ray Fischer
Adobe Systems
_______________________________________________
accessibility-dev mailing list | email@hidden
Help/Unsubscribe/Archives:
http://www.lists.apple.com/mailman/listinfo/accessibility-dev
Do not post admin requests to the list. They will be ignored.