Clock javadoc

Added JavaDoc to timeBetween method in Clock interface, which should
conclude the interface.