RFR: 8159527: Collections mutator methods should all be marked as optional operations

[Naoto Sato]

On Wed, 2 Aug 2023 20:11:35 GMT, Stuart Marks <smarks at openjdk.org> wrote:

> Adjust the leading javadoc sentence of several collections mutator methods to include "(optional operation)" as appropriate. Also adjust doc for UnsupportedOperationException on those methods as necessary.

Marked as reviewed by naoto (Reviewer).

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

PR Review: https://git.openjdk.org/jdk/pull/15127#pullrequestreview-1561935117