updating misleading javadoc parm