javadoc supplemented.