Updated Clock Documentation

this should be in several lines; do not go over 80 or 100 chars if there's no good reason to do so.