add docstring and fixup error msg