Add a note to the JavaInfo documentation about binary targets

Fixes #22147

PiperOrigin-RevId: 633506820
Change-Id: I952de33d922a00d135b58703bfd2036a41b0cccb

src/main/java/com/google/devtools/build/lib/starlarkbuildapi/java/JavaInfoApi.java

@@ -39,13 +39,23 @@ public interface JavaInfoApi<
 
   @StarlarkMethod(
       name = "transitive_runtime_jars",
-      doc = "Returns a transitive set of Jars required on the target's runtime classpath.",
+      doc =
+          """
+Returns a transitive set of Jars required on the target's runtime classpath.
+<p/>Note: for binary targets (such as java_binary and java_test), this is empty, since such targets
+are not intended to be dependencies of other Java targets.
+""",
       structField = true)
   Depset getTransitiveRuntimeJars();
 
   @StarlarkMethod(
       name = "transitive_compile_time_jars",
-      doc = "Returns the transitive set of Jars required to build the target.",
+      doc =
+          """
+Returns the transitive set of Jars required to build the target.
+<p/>Note: for binary targets (such as java_binary and java_test), this is empty, since such targets
+are not intended to be dependencies of other Java targets.
+""",
       structField = true)
   Depset getTransitiveCompileTimeJars();
 

src/main/starlark/builtins_bzl/common/java/java_info.bzl

@@ -770,8 +770,16 @@ def _javainfo_init(
 JavaInfo, _new_javainfo = provider(
     doc = "Info object encapsulating all information by java rules.",
     fields = {
-        "transitive_runtime_jars": "(depset[File]) A transitive set of jars required on the runtime classpath.",
-        "transitive_compile_time_jars": "(depset[File]) The transitive set of jars required to build the target.",
+        "transitive_runtime_jars": """(depset[File]) A transitive set of jars required on the
+        runtime classpath.
+        <p/>Note: for binary targets (such as java_binary and java_test), this is empty, since such
+        targets are not intended to be dependencies of other Java targets.
+        """,
+        "transitive_compile_time_jars": """(depset[File]) The transitive set of jars required to
+        build the target.
+        <p/>Note: for binary targets (such as java_binary and java_test), this is empty, since such
+        targets are not intended to be dependencies of other Java targets.
+        """,
         "compile_jars": """(depset[File]) The jars required directly at compile time. They can be interface jars
                 (ijar or hjar), regular jars or both, depending on whether rule
                 implementations chose to create interface jars or not.""",