Several improvments have been suggested to the API chnanges being done in as part of Project Coin/JSR 334:

Run-on sentence in Throwable:

             * In contrast, when one exception suppresses
             * another, two exceptions are thrown in sibling code blocks, such
             * as in a {@code try} block and in its {@code finally} block, and
             * control flow can only continue with one exception so the second
             * is recorded as a suppressed exception of the first.

Add usage note on reusing an exception object as one legitimate reason to make it immutable.

Clarity usage constraints in SafeVarargs.