fixes #4, updated/clarified docs