Fixed descriptions

The description of some functions were missleading; minor bugfixes on
return values.