Posted by
pudge
on from the documentation-gooooood dept.
ZigMonty writes "Apple has updated their Kernel Programming docs (May 1st). They are a lot more substantial now (read: they say something other than 'don't')."
Re:humor in the manaul
by
Matthias+Wiesmann
·
· Score: 2, Interesting
This is typical, many Apple docs were peppered with jokes. The examples for the GUI in the Inside Macintosh were about about SurfWriter, the coolest word processor (or something like that). Most glossaries had an (incomplete) entry for RTFM, etc...
Good documentation is scarce
by
cremes
·
· Score: 2, Interesting
I went through the previous incarnation of this manual and it was pretty lousy. I haven't had a good chance yet to study this one, but if they added any new information to it then I'll be happy.
The documentation for Apple's new systems has been rather poor. I've been writing an IOKit driver (check it out at http://sourceforge.net/projects/darwin-tulip/) and had a hell of a time figuring out some of the tricks. Some of that was related to this project being my first attempt at a driver (:-), but there were some critical areas where the documentation stopped dead in its tracks and said "This section is not written yet." D'oh!
My next project after this ethernet driver is to write either a) an opensource tool to defrag HFS+, or b) a VFS driver. If I do (a) first it will help with (b). I'm counting on there being better documentation on VFS than currently exists. I've started looking at the source code (the only documentation that exists on VFS), but it can take many months to become proficient with its internal workings; good doc should cut that down some.
cr
Many documentation updates...
by
h0tblack
·
· Score: 3, Interesting
...have appeared in the build up to the start of the WWDC (today). There's also an updated "UNIX Porting Guide" http://developer.apple.com/techpubs/macosx /Darwin/ index.html
All of the latest updates can be found here: http://developer.apple.com/techpubs/macosx/ whatsne w.html
One of the older bits of documentation I came across recently was that on Assembly under OS X, including details for the i386 architecture. http://developer.apple.com/techpubs /macosx/Develop erTools/Assembler/AssemblerTOC.html
This is typical, many Apple docs were peppered with jokes. The examples for the GUI in the Inside Macintosh were about about SurfWriter, the coolest word processor (or something like that). Most glossaries had an (incomplete) entry for RTFM, etc...
I went through the previous incarnation of this manual and it was pretty lousy. I haven't had a good chance yet to study this one, but if they added any new information to it then I'll be happy.
The documentation for Apple's new systems has been rather poor. I've been writing an IOKit driver (check it out at http://sourceforge.net/projects/darwin-tulip/) and had a hell of a time figuring out some of the tricks. Some of that was related to this project being my first attempt at a driver (:-), but there were some critical areas where the documentation stopped dead in its tracks and said "This section is not written yet." D'oh!
My next project after this ethernet driver is to write either a) an opensource tool to defrag HFS+, or b) a VFS driver. If I do (a) first it will help with (b). I'm counting on there being better documentation on VFS than currently exists. I've started looking at the source code (the only documentation that exists on VFS), but it can take many months to become proficient with its internal workings; good doc should cut that down some.
cr
...have appeared in the build up to the start of the WWDC (today).x /Darwin/ index.html
/ whatsne w.html
s /macosx/Develop erTools/Assembler/AssemblerTOC.html
There's also an updated "UNIX Porting Guide"
http://developer.apple.com/techpubs/macos
All of the latest updates can be found here:
http://developer.apple.com/techpubs/macosx
One of the older bits of documentation I came across recently was that on Assembly under OS X, including details for the i386 architecture.
http://developer.apple.com/techpub