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