bugfix, added more informative docstrings