doc: revisions to clock.py (2)