Mailing Lists: Apple Mailing Lists
Image of Mac OS face in stamp
 
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Where's the documentation for system calls?

Scott,

I'm in full agreement with you.

The documentation is present - somewhere - but there are no good tools to
find it.

On Windows, you open the MSDN library, and do a search - either indexed
or full text, and you find things *very* easily.

Why hasn't someone done a similar thing for OS-X?

I'm not sure how many developers are turning away (already have turned
away?) because of this.

Thanks.

Devendra.

At 01:27 PM 4/25/2002, Scott Taggart wrote:

And here I go again - I go to find the documentation for the
supported #pragmas for the gnu C compiler. I find the online
documentation and it talks about 3 or 4 of them and none of the
rest. So, where's the "rest" of the documentation for the compiler
for the "rest of us"? I can't be the only person who needs to know
how these tools work...

Oh, yea, I could just check out the source for the entire compiler
and figure it out that way. Bill is starting to look better and
better... Sorry, but the documentation SUCKS.

At 12:16 PM 4/25/2002, Scott Taggart wrote:

Thanks, but I still have two problems (at the risk of exposing
myself as completely incompetent):

1) given some random function name that you have no idea where
it's base class is (if it's even a member of a class at all), how
are you supposed to quickly locate it - the documentation you
reference below has no "global" search capability (that I can
find). Once you know a given function's class, it's pretty easy
to find it. Not knowing the class leaves you wandering through
Hundreds of files... I end up getting on Apple's web site and
entering the name in the search box - this seems like not the
most direct route.

2) In the specific case I mentioned below, I said where's the doc
for clock_get_uptime(). By "dumb" luck, I see this is in fact a
macro that calls a function named __OSAbsoluteTime() which as
near as I can tell is a system global of some kind. Again, where
is the documentation on __OSAbsoluteTime()?

Scott

At 11:58 AM 4/25/2002, Wayne Flansburg wrote:

Scott there are no dumb questions. We all have to learn. Here
goes and I hope this helps.

yourHD/System/Library/Frameworks/Kernel.framework/Versions/Current(a
link)/Resources/English.lproj/Documentation/Reference/Kernel.

See almost in front of your nose. Just kidding, it took me
much longer.
Wayne

On Thursday, April 25, 2002, at 11:33 AM, Scott Taggart
wrote:

really dumb question - where exactly is the documentation
for all the kernal calls (e.g., clock_get_uptime()). I
searched everything I could and can't find anything. I
find sites that have mach docs but these are in
postscript - how are we mere mortals supposed to read
that?
There seem to be no X tools. I know I am missing
something here...

Scott
_______________________________________________
darwin-drivers mailing list |
email@hidden
Help/Unsubscribe/Archives:
http://www.lists.apple.com/mailman/listinfo/darwin-drivers
Do not post admin requests to the list. They will be
ignored.

************************************
Wayne Flansburg, Worldwide Technical Support
Visit our PCI web page at:
http://developer.apple.com/hardware/pci/
************************************

_______________________________________________
darwin-drivers mailing list | email@hidden
Help/Unsubscribe/Archives:
http://www.lists.apple.com/mailman/listinfo/darwin-drivers
Do not post admin requests to the list. They will be ignored.

_______________________________________________
darwin-drivers mailing list | email@hidden
Help/Unsubscribe/Archives:
http://www.lists.apple.com/mailman/listinfo/darwin-drivers
Do not post admin requests to the list. They will be ignored.

Devendra ParakhSinging Electrons, Inc.http://www.singingelectrons.com425-889-2478
_______________________________________________
darwin-drivers mailing list | email@hidden
Help/Unsubscribe/Archives: http://www.lists.apple.com/mailman/listinfo/darwin-drivers
Do not post admin requests to the list. They will be ignored.


Visit the Apple Store online or at retail locations.
1-800-MY-APPLE

Contact Apple | Terms of Use | Privacy Policy

Copyright © 2007 Apple Inc. All rights reserved.