improve javadoc documentation