improves javadoc