Minor improvements

Even though strictly a major should be released due to minor changes in an interface, the current usage of this package (and especially that the adjusted interface is probably not used outside the project) gives me the opportunity to treat this as a patch release with mainly minor documentation / return type improvements.