fixes #22 - documentation changes for 5.0.1

there were no other doc changes because the docs were right, but the code was wrong.