transformed some comments into docstrings
Ignore this commit; it doesn't actually do anything.