make our API docstrings more epydoc friendly