TRUNK-4254 : Added Javadoc for Clock and SystemClock.
Changed assertions tests to be more readable.
Plus the formatting changes done by maven plugin.