add parameter/return info to docstring of various methods