adding the 1.0 javadocs