Clarified and expanded which Builders were reusable

This additionally fixes both SI-8648 and SI-9564.

Added documentation to Builder to clarify that in general Builders are NOT reusable.

Altered implementation of GrowingBuilder to use Growable instance's clear (not valid for a reusable builder, but this one isn't reusable).

Added a new marker trait ReusableBuilder that specifies that these builders should be reusable.  This trait overrides the clear and result methods while leaving them abstract in order to supply appropriate scaladoc.

Made all Array builders Reusable in all cases (by setting capacity to 0 if the original array is returned).  (Fixed a poor implmentation of Array[Unit] builder along the way.)

Documented which other builders were already reusable (maps, sets, Vector, LazyBuilder, StringBuilder, ListBuffer, etc.).

0 files changed, 0 insertions, 0 deletions