updated javadoc to correspond to v3.2