Revise JavaDoc for add methods

Point out that add methods *append* values at the end of an array
or object.