Integrated: 8374717: Unclear wording in docs for recursion for List, Map and LazyConstant

[Per Minborg]

On Wed, 7 Jan 2026 13:20:20 GMT, Per Minborg <pminborg at openjdk.org> wrote:

> 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.

This pull request has now been integrated.

Changeset: 75172e06
Author:    Per Minborg <pminborg at openjdk.org>
URL:       https://git.openjdk.org/jdk/commit/75172e06585060e5efca080a11d8a8a51b40afed
Stats:     8 lines in 3 files changed: 0 ins; 1 del; 7 mod

8374717: Unclear wording in docs for recursion for List, Map and LazyConstant

Reviewed-by: rriggs

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

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