Massive javadoc update in preparation for 1.0