various doc improvements
more docstring improvements.