more accurate documentation for addValue() method