doc: revisions to clock.py