fixing typo on javadoc and improving it a bit