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.