added api doc for the tricky part of setValues.