From 8f8de04aafa0a5788d700abeca5cd9e1b578eb93 Mon Sep 17 00:00:00 2001 From: Ingo Schommer Date: Fri, 15 Oct 2010 03:26:27 +0000 Subject: [PATCH] MINOR Documentation in DataObjectSet (from r107400) git-svn-id: svn://svn.silverstripe.com/silverstripe/open/modules/sapphire/trunk@112575 467b73ca-7a2a-4603-9d3b-597d59a354a9 --- core/model/DataObjectSet.php | 5 +++++ 1 file changed, 5 insertions(+) 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') {