Updated javadocs for maths changes