tweak a docstring
make errors more specific
minor formatting