check for valid value and javadocs