diff --git a/core/model/DataObjectSet.php b/core/model/DataObjectSet.php index 5e1d92ba7..0e99c4f1e 100644 --- a/core/model/DataObjectSet.php +++ b/core/model/DataObjectSet.php @@ -524,6 +524,9 @@ class DataObjectSet extends ViewableData implements IteratorAggregate, Countable /** * Merge another set onto the end of this set. + * To merge without causing duplicates, consider calling + * {@link removeDuplicates()} after this method on the new set. + * * @param DataObjectSet $anotherSet Set to mege onto this set. */ public function merge($anotherSet){ @@ -822,6 +825,8 @@ class DataObjectSet extends ViewableData implements IteratorAggregate, Countable /** * Remove duplicates from this set based on the dataobjects field. * Assumes all items contained in the set all have that field. + * Useful after merging to sets via {@link merge()}. + * * @param string $field the field to check for duplicates */ public function removeDuplicates($field = 'ID') {