Improve javadocs #667