From dd12e08ac49a7e28ab685937d6426f6d623f0abd Mon Sep 17 00:00:00 2001
From: Nickita Khylkouski
 <90287684+nickita-khylkouski@users.noreply.github.com>
Date: Wed, 4 Feb 2026 07:53:04 -0800
Subject: [PATCH] MoreObjects: Document requireNonNullElseGet in firstNonNull
 Javadoc

Add mention of java.util.Objects.requireNonNullElseGet as the lazy
evaluation alternative for Java 9+ users.

Fixes #6283
---
 guava/src/com/google/common/base/MoreObjects.java | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/guava/src/com/google/common/base/MoreObjects.java b/guava/src/com/google/common/base/MoreObjects.java
index 76f3eee1bf85..0dcb99378847 100644
--- a/guava/src/com/google/common/base/MoreObjects.java
+++ b/guava/src/com/google/common/base/MoreObjects.java
@@ -54,7 +54,8 @@ public final class MoreObjects {
    * first.or(supplier)}.
    *
    * <p><b>Java 9 users:</b> use {@code java.util.Objects.requireNonNullElse(first, second)}
-   * instead.
+   * instead. For lazy evaluation of the fallback, use {@code
+   * java.util.Objects.requireNonNullElseGet(first, supplier)}.
    *
    * @return {@code first} if it is non-null; otherwise {@code second} if it is non-null
    * @throws NullPointerException if both {@code first} and {@code second} are null