runfiles.[root_]symlinks docs: Link to docs which explain these params in more depth
And which explain the difference between symlinks vs. root_symlinks.
RELNOTES: None.
PiperOrigin-RevId: 320047560
diff --git a/src/main/java/com/google/devtools/build/lib/skylarkbuildapi/StarlarkRuleContextApi.java b/src/main/java/com/google/devtools/build/lib/skylarkbuildapi/StarlarkRuleContextApi.java
index bd4b120..2316d5c 100644
--- a/src/main/java/com/google/devtools/build/lib/skylarkbuildapi/StarlarkRuleContextApi.java
+++ b/src/main/java/com/google/devtools/build/lib/skylarkbuildapi/StarlarkRuleContextApi.java
@@ -589,7 +589,7 @@
named = true,
doc =
"<b>Use of this parameter is not recommended. See "
- + "<a href=\"../rules.html#runfiles\">runfiles guide</a></b>. "
+ + "<a href=\"../rules.$DOC_EXT#runfiles\">runfiles guide</a></b>. "
+ "<p>Whether to collect the data "
+ "runfiles from the dependencies in srcs, data and deps attributes."),
@Param(
@@ -599,7 +599,7 @@
named = true,
doc =
"<b>Use of this parameter is not recommended. See "
- + "<a href=\"../rules.html#runfiles\">runfiles guide</a></b>. "
+ + "<a href=\"../rules.$DOC_EXT#runfiles\">runfiles guide</a></b>. "
+ "<p>Whether to collect the default "
+ "runfiles from the dependencies in srcs, data and deps attributes."),
@Param(
@@ -607,13 +607,19 @@
type = Dict.class,
defaultValue = "{}",
named = true,
- doc = "The map of symlinks to be added to the runfiles, prefixed by workspace name."),
+ doc =
+ "The map of symlinks to be added to the runfiles, prefixed by workspace name. See "
+ + "<a href=\"../rules.$DOC_EXT#runfiles-symlinks\">Runfiles symlinks</a> in "
+ + "the rules guide."),
@Param(
name = "root_symlinks",
type = Dict.class,
defaultValue = "{}",
named = true,
- doc = "The map of symlinks to be added to the runfiles.")
+ doc =
+ "The map of symlinks to be added to the runfiles. See "
+ + "<a href=\"../rules.$DOC_EXT#runfiles-symlinks\">Runfiles symlinks</a> in "
+ + "the rules guide.")
})
RunfilesApi runfiles(
Sequence<?> files,
