Many Calendar methods that take in a field parameter should document that they throw an ArrayIndexOutOfBoundsException if field is not between 0 and `Calendar.FIELD_COUNT`.
This PR adds a clause to the class description to make the above apparent. `Calendar.Roll(int, int)`, `Calendar.roll(int, boolean)`, and `Calendar.add(int, int)` should all be documented that they throw an `IllegalArgumentException` if any calendar fields have out-of-range values in non-lenient mode or if field is `Calendar.ZONE_OFFSET`, `Calendar.DST_OFFSET`, or unknown. ------------- Commit messages: - Replace method exceptions with a general clause in class description - Readjust add and roll to throw IAE (since jCal is private and cannot be specified) - Adjust add and roll - Adjust Add and Roll spec to use existing wording - Add exceptions to Calendar methods Changes: https://git.openjdk.org/jdk/pull/13234/files Webrev: https://webrevs.openjdk.org/?repo=jdk&pr=13234&range=00 Issue: https://bugs.openjdk.org/browse/JDK-4737887 Stats: 20 lines in 1 file changed: 13 ins; 5 del; 2 mod Patch: https://git.openjdk.org/jdk/pull/13234.diff Fetch: git fetch https://git.openjdk.org/jdk.git pull/13234/head:pull/13234 PR: https://git.openjdk.org/jdk/pull/13234
