RFR: 8349946: Cipher javadoc could describe AEAD reuse better [v3]

[Koushik Muthukrishnan Thirupattur]

> The class documentation in javax.crypto.Cipher could better describe AEAD and reuse. The current class description example is outdated as GCM encryption does not allow resets. The doc should state that reset() may not be possible with some algorithms or providers and that an InvalidAlgorithmParameterException is thrown

Koushik Muthukrishnan Thirupattur has updated the pull request incrementally with one additional commit since the last revision:

  8349946: Cipher javadoc could describe AEAD reuse better

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

Changes:
  - all: https://git.openjdk.org/jdk/pull/25399/files
  - new: https://git.openjdk.org/jdk/pull/25399/files/8d8446e3..fcc5baba

Webrevs:
 - full: https://webrevs.openjdk.org/?repo=jdk&pr=25399&range=02
 - incr: https://webrevs.openjdk.org/?repo=jdk&pr=25399&range=01-02

  Stats: 10 lines in 1 file changed: 0 ins; 0 del; 10 mod
  Patch: https://git.openjdk.org/jdk/pull/25399.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/25399/head:pull/25399

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