site_archiver@lists.apple.com Delivered-To: darwin-kernel@lists.apple.com Oops. The nice comments are not in Tiger. )-: Sorry. -- Terry _______________________________________________ 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... On Mar 7, 2007, at 6:29 AM, Anton Altaparmakov wrote: On 7 Mar 2007, at 09:20, Nikita Danilov wrote: 07/03/2007 13:36 +0000, Anton Altaparmakov: - Download the xnu sources from http://www.opensource.apple.com/ darwinsource/ and look in bsd/kern/ubc_subr.c. It has very good comments above most of the function (kind of Kernel doc style like in Linux but not quite). A couple of years ago, I used to read through osfmk/vm/ a lot, trying to understand UPL interface, hopefully it got better comments (read: any) since then. :-) I should note that I am looking at xnu trunk in Apple internal svn, i.e. what will be in Leopard when it is released. /me checks out the current Tiger 10.4.8 xnu tag (xnu-792.14.14) and looks at bsd/kern/ubc_subr.c(). I wonder if it would be allowed to cut the comments out of the current ubc_subr.c and make them public as a .txt file... /me writes a Sticky to remind me to ask... I wrote all those comments, plus commented a bunch of stuff elsewhere, any time I happened to make what I thought were extensive enough code changes in a given kernel source file. I also documented return codes for most functions in the underlying implementations of major POSIX subsystems in a bunch of other places, where the return codes could be ambiguous according to the standard, and tried to make it clear where/ what function the error codes (eventually) came from. 8-). I know that the UBC comments were sent to at least one external person who was working on a publication, so it can't hurt to ask... This email sent to site_archiver@lists.apple.com