RFR: JDK-8302323 Add repeat methods to StringBuilder/StringBuffer [v4]

[Roger Riggs]

On Tue, 28 Feb 2023 13:29:49 GMT, Jim Laskey <jlaskey at openjdk.org> wrote:

>> Add the ability to repeatedly append char and CharSequence data to StringBuilder/StringBuffer.
>
> Jim Laskey has updated the pull request incrementally with two additional commits since the last revision:
> 
>  - Remove @throws IndexOutOfBoundsException
>  - Change error report to use "is negative"

Changes requested by rriggs (Reviewer).

src/java.base/share/classes/java/lang/AbstractStringBuilder.java line 1835:

> 1833:      * @return  a reference to this object.
> 1834:      *
> 1835:      * @since 21

@since should be last / after \throws; here and in the other method added.

src/java.base/share/classes/java/lang/StringBuffer.java line 713:

> 711:     /**
> 712:      * @since 21
> 713:      * @throws IllegalArgumentException {@inheritDoc}

@throws comes before @since here and in StringBuilder.

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

PR: https://git.openjdk.org/jdk/pull/12728