Improved timespans.py docstrings.