Updated Clock Documentation

there are a lot of unneeded changes; please review them all...