big javadoc update, no code changes