make doc string more clear
improve test coverage a little