site_archiver@lists.apple.com Delivered-To: darwin-kernel@lists.apple.com On 18 May, 2010, at 07:44 , Ken Hornstein wrote:
If you find any documentation wanting in detail, please file a radar. There are limits to what we can cram into HeaderDoc, which is the only documentation I contribute directly to, but I spent the first half of my career as a technical writer so I take documentation very seriously and want to make sure it covers the bases. Any question you have that the doc doesn't address is a failure that needs to be corrected. You shouldn't have to experiment with our APIs to figure out how to use them.
Okay ... how do I do that, exactly? (I had some vague impression that radar is the Apple internal bug-tracking system).
I think this will work: http://developer.apple.com/bugreporter/
Just FYI, the two big thins documentation would have been nice for were the aforementioned issue with the callback not being called until after the start routine had exited, and the amazingly difficult question of "Where exactly ARE resource files located inside of a kext?" (The answer: ${KEXTDIR}/Contents/Resources. Hoo boy, that was a tough one to find, and if that is documented somewhere, please let me know, because I couldn't find it!).
The first issue is definitely worth addressing. The second, I can probably fit in, but we do assume developers have read an overview of the OS, including bundle structure. That said, kext development makes minimal use of that structure, so again it's worth mentioning. I've filed the radars for those two issues directly, since I have the info. Cheers, Nik _______________________________________________ Do not post admin requests to the list. They will be ignored. Darwin-kernel mailing list (Darwin-kernel@lists.apple.com) Help/Unsubscribe/Update your Subscription: http://lists.apple.com/mailman/options/darwin-kernel/site_archiver%40lists.a... This email sent to site_archiver@lists.apple.com