RFR: 8374717: Unclear wording in docs for recursion for List, Map and LazyConstant
Per Minborg
pminborg at openjdk.org
Wed Jan 7 13:43:37 UTC 2026
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
More information about the core-libs-dev
mailing list