documentation for iterator argument to uniq is confusing

[joelmccracken]

I expected iterator to be called with each combination of elements, thus it would have a signature like:

$artist_files = __($artist_files)->uniq(false, function($a, $b){
    return $a->id == $b->id;
  });

Instead, I needed to change this to:

$artist_files = __($artist_files)->uniq(false, function($a){
    return $a->id;
  });

Clearly, the implementation provided by underscore.php is better than the one I expected. I just needed to read the source to understand what was up.

I think the reason I misunderstood this was because I did not realize that there is an assumed 1 to 1 mapping of uniquely identifying values for all possible inputs.

Anyway, a more thorough explanation of the iterator function would probably be a good idea.

Thanks!