RFR: 6241286: (cal) API: Calendar.DAY_OF_WEEK definition is wrong

Wed Apr 5 05:08:03 UTC 2023

This PR updates the Calendar.DAY_OF_WEEK documentation to make it clear that the field accepts _any_ value if the calendar is lenient and then normalizes it. Only if the calendar is non-lenient, will the field accept only one of SUNDAY ... SATURDAY.

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

Commit messages:
 - Redudant wording
 - Adjust doc

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

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