RFR: 8361615: CodeBuilder::parameterSlot throws undocumented IOOBE

[Chen Liang]

In a recent inspection of all methods that accept an `int` argument in the Class-File API, I noticed this method that validates its argument but did not document the validation. The behavior is to throw IOOBE. We can simply document this behavior and enhance existing tests to verify exceptional behaviors in addition to anticipated outputs.

This is doc plus test only, so should be eligible for backport regardless of priority. A CSR will be created to track this new assertion in the spec.

Testing: jdk/jdk/classfile/BuilderParamTest.java

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

Commit messages:
 - 8361615: CodeBuilder::parameterSlot throws undocumented IOOBE

Changes: https://git.openjdk.org/jdk/pull/26200/files
  Webrev: https://webrevs.openjdk.org/?repo=jdk&pr=26200&range=00
  Issue: https://bugs.openjdk.org/browse/JDK-8361615
  Stats: 10 lines in 2 files changed: 9 ins; 0 del; 1 mod
  Patch: https://git.openjdk.org/jdk/pull/26200.diff
  Fetch: git fetch https://git.openjdk.org/jdk.git pull/26200/head:pull/26200

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