Tuesday, August 4, 2009

Developer Connection

If you thought (like I did) that TFS documentation was bad, check out this beauty:

http://developer.apple.com/documentation/appleapplications/Reference/WebKitDOMRef/DOMSelection_idl/Classes/DOMSelection/index.html

As a mental exercise, try to guess what does empty() do? Does it empty the selection? Or does it return true if the selection is empty?

2 comments:

Anonymous said...

Since the return type is void and ti dont take any params im guessing it empties the selection ;) But yeah its not documentation, its lack of it.

Ripper

Unknown said...

Well, it's difficult to return 'true' from a function declared as _void_ empty();

Some documentations out there does really suck. Apple's usually not in this category. However, the likes of http://msdn.microsoft.com/en-us/library/dd389403(VS.85).aspx might actually be among the forerunners.