Added comments to src.util

Mostly docstrings, includes some inline comment cleanup as well.