RFR: 8261301: StringWriter.flush() is NOOP but documentation does not indicate it

[Roger Riggs]

On Wed, 7 Apr 2021 21:01:48 GMT, Brian Burkhalter <bpb at openjdk.org> wrote:

> The specification of the method `flush()` in the `java.io` classes `CharArrayWriter` and `StringWriter` is not explicit about the fact that the method has no effect. This request proposes to add to the specification of each flush() method the sentence
> The {@code flush} method of {@code <ClassName/>} does nothing.
> The corresponding CSR is JDK-8264867.

In the CSR, the first sentence of the Summary should be context free.
It is used standalone in other contexts to describe the change.  Perhaps change to:
"Clarify the `flush` methods in java.io classes CharArrayWriter and StringWriter do nothing."

-------------

Marked as reviewed by rriggs (Reviewer).

PR: https://git.openjdk.java.net/jdk/pull/3383