Would be good to update this javadoc.