Yet another run at reduce (collect)

[Aleksey Shipilev]

On 01/09/2013 11:25 PM, Doug Lea wrote:
> On 01/09/13 13:56, Brian Goetz wrote:
>> I've pushed a rename to collect().  Check it out.
> 
> Yay! Thanks!

Ok, this is quite an intrusive change to adapt for my performance tests.
Can you please add more Javadocs for Collector? In fact, I need more
details on:
 a) Should makeResult() return the new result on every call?
 b) Can combine(result, other) return updated $result, or it should
return distinct collectable?

-Aleksey.