change line breaking in some places
add :param to docstrings
remove useless comments