makeValidOptions, ready for re-jar
commented, ready to re-jar and javadoc