The factory methods `(List|Map)::ofLazy` and `LazyConstant::get` specify that
an `IllegalStateException` is thrown upon a recursive invocation of the
computing function. However, it is not clear that this *only* applies if
recursion is made through the lazy entity (and not direct recursion on the
computing function itself).
This PR proposes to improve the wording in the docs for lazy constructs. This
is a doc-only change.
For example, we could replace the word "or" with the word "via" in the
`List::ofLazy` specification so that it says:
* If the provided computing function recursively calls itself via the
returned
* lazy list for the same index, an {@linkplain IllegalStateException}
* will be thrown.
-------------
Commit messages:
- Update copyright years
- Clarify recursive invocation in the docs
Changes: https://git.openjdk.org/jdk/pull/29091/files
Webrev: https://webrevs.openjdk.org/?repo=jdk&pr=29091&range=00
Issue: https://bugs.openjdk.org/browse/JDK-8374717
Stats: 8 lines in 3 files changed: 0 ins; 1 del; 7 mod
Patch: https://git.openjdk.org/jdk/pull/29091.diff
Fetch: git fetch https://git.openjdk.org/jdk.git pull/29091/head:pull/29091
PR: https://git.openjdk.org/jdk/pull/29091
