Re: Docs
Re: Docs
- Subject: Re: Docs
- From: "Michael A. Crawford" <email@hidden>
- Date: Wed, 22 Aug 2001 19:54:40 -0700
On 8/22/01 14:13, "Stuppel, Searle @ San Diego Central" <email@hidden>
wrote:
>
Now i am sure i can see the response i am going to get to this (namely
>
"RTFM"), but the problem i think a lot of the moew beginner people (like
>
myself have) is not that the informatio is not in the manual, we just dont
>
know WHERE it is in the manual.
>
>
Today i just discovered NSScanner. What a great function set. I had no idea
>
it existed.
>
>
What I think might be VERY helpful, is a simple list of major structures and
>
what they do/deal with in a single line:
>
>
eg.
>
>
NSString- string funtions
>
NSDictionary .......
>
NSScanner- text handling
>
NSURL - url handling
>
>
etc. etc.
>
>
A single line comment like that for all the API's would be so helpful. That
>
way when i need help on some string thing, i can quickly find out where to
>
start looking, rather than sending email to this list and getting back a
>
RTFM!
>
>
searle
>
>
>
Searle Stuppel
>
CB Richard Ellis, Inc.
>
Direct: 858-546-4600
>
Fax: 858-546-4616
>
Toll Free: 800-334-9347
>
email@hidden
>
_______________________________________________
>
cocoa-dev mailing list
>
email@hidden
>
http://www.lists.apple.com/mailman/listinfo/cocoa-dev
Disclaimer: Forgive me if I say something that has already been said
regarding this thread.
I'm having a tough time finding documentation for many of the interfaces in
the Apple programming environment. A decent class reference is desperately
needed but some of us are using more than just Cocoa. For instance, someone
mentioned a function called microtime(), which is part of Darwin--which part
I don't know, in a different thread. I couldn't find any documentation on
the function. Granted I haven't made an exhaustive search. I grep'd and
ls'd in '/usr/include' without success. I'm an escapee from the Wintel
environment. When it comes to easily referencing the documentation for
frameworks, classes, and functions, Visual C++ and MSDN seem to do a much
better job than Apple's PB. I love the way PB indexes my files so that I
can find methods and data that I've declared but perhaps Apple could go a
step farther and allow me to use the same interface to lookup Apple APIs?
All of them at every level?
Perhaps this is already available and I'm just too new to know what I'm
doing. In that case, I'll be happy to make a retraction as soon as
somewhere tells me how to activate this feature.
Sorry if I got a little off topic.
-Michael