various fixes to docstrings