another humongous  commit with javadoc update