Function description, supported version information, header-file and library file information, meaningful return code documentation, links to an overview of the system wait behaviors, documentation about what happens in low power situations, links to example code using the function, differences in behavior between differing versions, it goes on and on.
Can you point to something you think is better?
PS: I should point out, I have paper copies of the win32 api from the early 1990's that are falling apart from the use they got.
Arr, sorry I misread your comment. I am on your side when it comes to Windows API. But I am not sure if it's a thing of the past. Imo Microsoft is pretty good when it comes to documentation. The way of presentation can be improved, but I really appreciate it. I think it's a culture thing and that culture seems to be different within Apple... I think this is also visible when it comes to their app store policies....
That is a good one too, but its not in as bad of shape as my official win32 guides from MS. My copy of Volume 2 of the win32 reference has nearly as much tape as paper, although I haven't picked it up in probably 10 years.
edit: Holy crap, in an effort to find an online picture of the volume, i noticed that amazon is selling the slightly newer ones for over $800. Looks like I should have taken better care of it.
