Thanks for pointing out the shortcomings of the docs - however as they are part of the source code as well, maybe you could create a pull request which would address the issues mentioned and fix the docs where needed?