applied javadoc cleanup patch from http://issues.apache.org/bugzilla/show_bug.cgi?id=35676 (did not apply the VariableFormatter javadoc path since this class is still being worked)