clock: update package documentation; See #71
clock: fix two potential data races; See #71