more docstrings, options
minor updates