Reword some comments and docstrings to make them clearer.

Thanks!