Bazel DevSite: Replace $STARLARK_DOCS_ROOT with actual value.
The pages in question don't have an internal equivalent, i.e. we can simply hardcode the entire URL (including correct file extension) instead of using the variable.
Drive-by fix: Fix link anchors.
PiperOrigin-RevId: 441473555
diff --git a/src/main/java/com/google/devtools/build/lib/packages/StarlarkLibrary.java b/src/main/java/com/google/devtools/build/lib/packages/StarlarkLibrary.java
index 6946c5f..2fe295b 100644
--- a/src/main/java/com/google/devtools/build/lib/packages/StarlarkLibrary.java
+++ b/src/main/java/com/google/devtools/build/lib/packages/StarlarkLibrary.java
@@ -334,7 +334,7 @@
"A dict that maps configuration conditions to values. Each key is a "
+ "<a href=\"Label.html\">Label</a> or a label string"
+ " that identifies a config_setting or constraint_value instance. See the"
- + " <a href=\"$STARLARK_DOCS_ROOT/macros.html#label-resolution-in-macros\">"
+ + " <a href=\"https://bazel.build/rules/macros#label-resolution\">"
+ "documentation on macros</a> for when to use a Label instead of a string."),
@Param(
name = "no_match_error",
diff --git a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/ActionApi.java b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/ActionApi.java
index c10c35f..abff4ec 100644
--- a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/ActionApi.java
+++ b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/ActionApi.java
@@ -35,7 +35,7 @@
+ " testing, and may be obtained from an <a href=\"globals.html#Actions\">Actions</a>"
+ " provider. It is normally not necessary to access <code>Action</code> objects or"
+ " their fields within a rule's implementation function. You may instead want to see"
- + " the <a href='$STARLARK_DOCS_ROOT/rules.html#actions'>Rules page</a> for a general"
+ + " the <a href='https://bazel.build/rules/rules#actions'>Rules page</a> for a general"
+ " discussion of how to use actions when defining custom rules, or the <a"
+ " href='actions.html'>API reference</a> for creating actions.<p>Some fields of this"
+ " object are only applicable for certain kinds of actions. Fields that are"
diff --git a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/BuildConfigurationApi.java b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/BuildConfigurationApi.java
index 5c8ff1c..bc79f49 100644
--- a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/BuildConfigurationApi.java
+++ b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/BuildConfigurationApi.java
@@ -28,7 +28,7 @@
category = DocCategory.BUILTIN,
doc =
"This object holds information about the environment in which the build is running. See the"
- + " <a href='$STARLARK_DOCS_ROOT/rules.html#configurations'>Rules page</a> for more on"
+ + " <a href='https://bazel.build/rules/rules#configurations'>Rules page</a> for more on"
+ " the general concept of configurations.")
public interface BuildConfigurationApi extends StarlarkValue {
diff --git a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/CommandLineArgsApi.java b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/CommandLineArgsApi.java
index 177d9dd..2d0a972 100644
--- a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/CommandLineArgsApi.java
+++ b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/CommandLineArgsApi.java
@@ -49,7 +49,7 @@
+ "manipulating the data. <code>Args</code> objects do not process the depsets they "
+ "encapsulate until the execution phase, when it comes time to calculate the command "
+ "line. This helps defer any expensive copying until after the analysis phase is "
- + "complete. See the <a href='$STARLARK_DOCS_ROOT/performance.html'>Optimizing "
+ + "complete. See the <a href='https://bazel.build/rules/performance'>Optimizing "
+ "Performance</a> page for more information."
+ ""
+ "<p><code>Args</code> are constructed by calling <a href='actions.html#args'><code>"
diff --git a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/DefaultInfoApi.java b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/DefaultInfoApi.java
index 64df1cc..d0b1ee1 100644
--- a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/DefaultInfoApi.java
+++ b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/DefaultInfoApi.java
@@ -38,13 +38,13 @@
+ " rule's implementation function. Each <code>DefaultInfo</code> instance has the"
+ " following fields: <ul><li><code>files</code><li><code>files_to_run</code>"
+ "<li><code>data_runfiles</code><li><code>default_runfiles</code></ul>See the <a"
- + " href='$STARLARK_DOCS_ROOT/rules.html'>rules</a> page for extensive guides on how to"
- + " use this provider.")
+ + " href='https://bazel.build/rules/rules'>rules</a> page for extensive guides on"
+ + " how to use this provider.")
public interface DefaultInfoApi extends StructApi {
static final String DEPRECATED_RUNFILES_PARAMETER_WARNING =
"<p><b>It is recommended that you avoid using this parameter (see "
- + "<a href='$STARLARK_DOCS_ROOT/rules.html#runfiles-features-to-avoid'>"
+ + "<a href='https://bazel.build/rules/rules#runfiles_features_to_avoid'>"
+ "\"runfiles features to avoid\"</a>)</b></p> ";
@StarlarkMethod(
@@ -75,7 +75,7 @@
"runfiles descriptor describing the files that this target needs when run in the "
+ "condition that it is a <code>data</code> dependency attribute. Under most "
+ "circumstances, use the <code>default_runfiles</code> parameter instead. "
- + "See <a href='$STARLARK_DOCS_ROOT/rules.html#runfiles-features-to-avoid'>"
+ + "See <a href='https://bazel.build/rules/rules#runfiles_features_to_avoid'>"
+ "\"runfiles features to avoid\"</a> for details. ",
structField = true,
allowReturnNones = true)
diff --git a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/FileApi.java b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/FileApi.java
index b1402ed..960b219 100644
--- a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/FileApi.java
+++ b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/FileApi.java
@@ -33,7 +33,7 @@
+ "and cannot be used to directly read or write file contents. Rather, you use it to "
+ "construct the action graph in a rule implementation function by passing it to "
+ "action-creating functions. See the "
- + "<a href='$STARLARK_DOCS_ROOT/rules.html#files'>Rules page</a> for more information."
+ + "<a href='https://bazel.build/rules/rules#files'>Rules page</a> for more information."
+ "" // curse google-java-format b/145078219
+ "<p>When a <code>File</code> is passed to an <a"
+ " href='Args.html'><code>Args</code></a> object without using a"
diff --git a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/FragmentCollectionApi.java b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/FragmentCollectionApi.java
index 2757ef8..867591f 100644
--- a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/FragmentCollectionApi.java
+++ b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/FragmentCollectionApi.java
@@ -28,6 +28,6 @@
+ " context. Access a specific fragment by its field name. For example,"
+ " <code>ctx.fragments.java</code> <p>Only configuration fragments which are declared"
+ " in the rule definition may be accessed in this collection.</p><p>See <a"
- + " href=\"$STARLARK_DOCS_ROOT/rules.html#configuration-fragments\">rules"
+ + " href=\"https://bazel.build/rules/rules#configuration_fragments\">rules"
+ " documentation</a> for details.")
public interface FragmentCollectionApi extends Structure, StarlarkValue {}
diff --git a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/OutputGroupInfoApi.java b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/OutputGroupInfoApi.java
index 0609a28..2e2a4ee 100644
--- a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/OutputGroupInfoApi.java
+++ b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/OutputGroupInfoApi.java
@@ -30,7 +30,7 @@
category = DocCategory.PROVIDER,
doc =
"A provider that indicates what output groups a rule has.<br>See <a"
- + " href=\"$STARLARK_DOCS_ROOT/rules.html#requesting-output-files\">Requesting output"
+ + " href=\"https://bazel.build/rules/rules#requesting_output_files\">Requesting output"
+ " files</a> for more information.")
public interface OutputGroupInfoApi extends StructApi {
@@ -43,7 +43,7 @@
doc =
"Instantiate this provider with <br><pre class=language-python>OutputGroupInfo(group1 ="
+ " <files>, group2 = <files>...)</pre>See <a"
- + " href=\"$STARLARK_DOCS_ROOT/rules.html#requesting-output-files\">Requesting"
+ + " href=\"https://bazel.build/rules/rules#requesting_output_files\">Requesting"
+ " output files </a> for more information.",
extraKeywords =
@Param(name = "kwargs", defaultValue = "{}", doc = "Dictionary of arguments."),
diff --git a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkActionFactoryApi.java b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkActionFactoryApi.java
index d52748e..4c8c57c 100644
--- a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkActionFactoryApi.java
+++ b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkActionFactoryApi.java
@@ -47,7 +47,7 @@
+ " addition to declaring a file, you must separately create an action that emits the"
+ " file. Creating that action will require passing the returned <code>File</code>"
+ " object to the action's construction function.<p>Note that <a"
- + " href='$STARLARK_DOCS_ROOT/rules.html#files'>predeclared output files</a> do not"
+ + " href='https://bazel.build/rules/rules#files'>predeclared output files</a> do not"
+ " need to be (and cannot be) declared using this function. You can obtain their"
+ " <code>File</code> objects from <a"
+ " href=\"ctx.html#outputs\"><code>ctx.outputs</code></a> instead. <a"
diff --git a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkAspectApi.java b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkAspectApi.java
index 6446a47..6c1744d 100644
--- a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkAspectApi.java
+++ b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkAspectApi.java
@@ -25,5 +25,5 @@
doc =
"For more information about Aspects, please consult the <a href=\"globals.html#aspect\">"
+ "documentation of the aspect function</a> or the "
- + "<a href=\"$STARLARK_DOCS_ROOT/aspects.md\">introduction to Aspects</a>.")
+ + "<a href=\"https://bazel.build/rules/aspects\">introduction to Aspects</a>.")
public interface StarlarkAspectApi extends StarlarkValue {}
diff --git a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkAttrModuleApi.java b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkAttrModuleApi.java
index 8e6bb52..437b99c 100644
--- a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkAttrModuleApi.java
+++ b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkAttrModuleApi.java
@@ -45,8 +45,8 @@
+ " objects are used as the values of the <code>attrs</code> dictionary argument of <a"
+ " href=\"globals.html#rule\"><code>rule()</code></a> and <a"
+ " href=\"globals.html#aspect\"><code>aspect()</code></a>.<p>See the Rules page for"
- + " more on <a href='$STARLARK_DOCS_ROOT/rules.html#attributes'>defining</a> and <a"
- + " href='$STARLARK_DOCS_ROOT/rules.html#implementation-function'>using</a>"
+ + " more on <a href='https://bazel.build/rules/rules#attributes'>defining</a> and <a"
+ + " href='https://bazel.build/rules/rules#implementation_function'>using</a>"
+ " attributes.")
public interface StarlarkAttrModuleApi extends StarlarkValue {
@@ -238,7 +238,7 @@
+ " attribute. If you also want to prevent users from overriding this default, you"
+ " can make the attribute private by giving it a name that starts with an"
+ " underscore. See the <a"
- + " href='$STARLARK_DOCS_ROOT/rules.html#private-attributes'>Rules</a> page for more"
+ + " href='https://bazel.build/rules/rules#private-attributes'>Rules</a> page for more"
+ " information.",
parameters = {
@Param(
diff --git a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkBuildApiGlobals.java b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkBuildApiGlobals.java
index 38f5159..83fa078 100644
--- a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkBuildApiGlobals.java
+++ b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkBuildApiGlobals.java
@@ -31,7 +31,7 @@
"References a late-bound default value for an attribute of type <a"
+ " href=\"attr.html#label\">label</a>. A value is 'late-bound' if it requires the"
+ " configuration to be built before determining the value. Any attribute using this"
- + " as a value must <a href=\"$STARLARK_DOCS_ROOT/rules.html#private-attributes\">be"
+ + " as a value must <a href=\"https://bazel.build/rules/rules#private-attributes\">be"
+ " private</a>. <p>Example usage: <p>Defining a rule attribute: <br><pre"
+ " class=language-python>'_foo':"
+ " attr.label(default=configuration_field(fragment='java', "
diff --git a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkRuleContextApi.java b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkRuleContextApi.java
index 069ef0e..e6175dc 100644
--- a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkRuleContextApi.java
+++ b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkRuleContextApi.java
@@ -52,7 +52,7 @@
+ " them.<p>Context objects essentially live for the duration of the call to the"
+ " implementation function. It is not useful to access these objects outside of their"
+ " associated function. See the <a"
- + " href='$STARLARK_DOCS_ROOT/rules.html#implementation-function'>Rules page</a> for"
+ + " href='https://bazel.build/rules/rules#implementation_function'>Rules page</a> for"
+ " more information.")
public interface StarlarkRuleContextApi<ConstraintValueT extends ConstraintValueInfoApi>
extends StarlarkValue {
@@ -81,7 +81,7 @@
+ " href='File.html'><code>File</code></a>s. It is a shortcut for:<pre"
+ " class=language-python>[f for t in ctx.attr.<ATTR> for f in t.files]</pre> In"
+ " other words, use <code>files</code> to access the <a"
- + " href=\"$STARLARK_DOCS_ROOT/rules.html#requesting-output-files\">default outputs</a>"
+ + " href=\"https://bazel.build/rules/rules#requesting_output_files\">default outputs</a>"
+ " of a dependency. <a"
+ " href=\"https://github.com/bazelbuild/examples/blob/main/rules/depsets/foo.bzl\">See"
+ " example of use</a>.";
@@ -96,13 +96,13 @@
+ " no corresponding struct field is generated. It is a shortcut for:<pre"
+ " class=language-python>list(ctx.attr.<ATTR>.files)[0]</pre>In other words, use"
+ " <code>file</code> to access the (singular) <a"
- + " href=\"$STARLARK_DOCS_ROOT/rules.html#requesting-output-files\">default output</a> of"
- + " a dependency. <a"
+ + " href=\"https://bazel.build/rules/rules#requesting_output_files\">default output</a>"
+ + " of a dependency. <a"
+ " href=\"https://github.com/bazelbuild/examples/blob/main/rules/expand_template/hello.bzl\">See"
+ " example of use</a>.";
String ATTR_DOC =
"A struct to access the values of the <a"
- + " href='$STARLARK_DOCS_ROOT/rules.html#attributes'>attributes</a>. The values are"
+ + " href='https://bazel.build/rules/rules#attributes'>attributes</a>. The values are"
+ " provided by the user (if not, a default value is used). The attributes of the struct"
+ " and the types of their values correspond to the keys and values of the <a"
+ " href='globals.html#rule.attrs'><code>attrs</code> dict</a> provided to the <a"
@@ -120,7 +120,7 @@
String OUTPUTS_DOC =
"A pseudo-struct containing all the predeclared output files, represented by <a"
+ " href='File.html'><code>File</code></a> objects. See the <a"
- + " href='$STARLARK_DOCS_ROOT/rules.html#files'>Rules page</a> for more information and"
+ + " href='https://bazel.build/rules/rules#files'>Rules page</a> for more information and"
+ " examples.<p>This field does not exist on aspect contexts, since aspects do not have"
+ " predeclared outputs.<p>The fields of this object are defined as follows. It is an"
+ " error if two outputs produce the same field name or have the same label.<ul><li>If"
@@ -572,7 +572,7 @@
doc =
"Either a SymlinkEntry depset or the map of symlinks, prefixed by workspace name,"
+ " to be added to the runfiles. See <a"
- + " href=\"$STARLARK_DOCS_ROOT/rules.html#runfiles-symlinks\">Runfiles"
+ + " href=\"https://bazel.build/rules/rules#runfiles_symlinks\">Runfiles"
+ " symlinks</a> in the rules guide."),
@Param(
name = "root_symlinks",
@@ -584,7 +584,7 @@
},
doc =
"Either a SymlinkEntry depset or a map of symlinks to be added to the runfiles. See"
- + " <a href=\"$STARLARK_DOCS_ROOT/rules.html#runfiles-symlinks\">Runfiles"
+ + " <a href=\"https://bazel.build/rules/rules#runfiles_symlinks\">Runfiles"
+ " symlinks</a> in the rules guide.")
})
RunfilesApi runfiles(
diff --git a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkRuleFunctionsApi.java b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkRuleFunctionsApi.java
index 6715a30..bc3405e 100644
--- a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkRuleFunctionsApi.java
+++ b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/StarlarkRuleFunctionsApi.java
@@ -65,14 +65,14 @@
+ " # my_info.x == 2\n"
+ " # my_info.y == 3\n"
+ " ..." //
- + "</pre><p>See <a href='$STARLARK_DOCS_ROOT/rules.html#providers'>Rules"
+ + "</pre><p>See <a href='https://bazel.build/rules/rules#providers'>Rules"
+ " (Providers)</a> for a comprehensive guide on how to use providers." //
+ "<p>Returns a <a href='Provider.html#Provider'><code>Provider</code></a> callable "
+ "value if <code>init</code> is not specified." //
+ "<p>If <code>init</code> is specified, returns a tuple of 2 elements: a <a"
+ " href='Provider.html#Provider'><code>Provider</code></a> callable value and a"
+ " <em>raw constructor</em> callable value. See <a"
- + " href='$STARLARK_DOCS_ROOT/rules.html#custom-initialization-of-providers'>Rules"
+ + " href='https://bazel.build/rules/rules#custom_initialization_of_providers'>Rules"
+ " (Custom initialization of custom providers)</a> and the discussion of the"
+ " <code>init</code> parameter below for details.",
parameters = {
@@ -109,7 +109,7 @@
+ " <code>provider()</code> returns a tuple of 2 elements: the normal provider"
+ " symbol and a <em>raw constructor</em>." //
+ "<p>A precise description follows; see <a"
- + " href='$STARLARK_DOCS_ROOT/rules.html#custom-initialization-of-providers'>"
+ + " href='https://bazel.build/rules/rules#custom_initialization_of_providers'>"
+ "Rules (Custom initialization of providers)</a>"
+ " for an intuitive discussion and use cases." //
+ "<p>Let <code>P</code> be the provider symbol created by calling"
@@ -209,8 +209,8 @@
+ " considered <a href='#rule.executable'>executable</a>; it is unnecessary"
+ " (and discouraged) to explicitly set <code>executable = True</code> for a"
+ " test rule. See the <a"
- + " href='$STARLARK_DOCS_ROOT/rules.html#executable-rules-and-test-rules'>Rules"
- + " page</a> for more information."),
+ + " href='https://bazel.build/rules/rules#executable_rules_and_test_rules'>"
+ + " Rules page</a> for more information."),
@Param(
name = "attrs",
allowedTypes = {
@@ -248,7 +248,7 @@
+ " href='attr.html#output'><code>output</code></a> and <a"
+ " href='attr.html#output_list'><code>output_list</code></a> attributes, the"
+ " user does not specify the labels for these files. See the <a"
- + " href='$STARLARK_DOCS_ROOT/rules.html#files'>Rules page</a> for more on"
+ + " href='https://bazel.build/rules/rules#files'>Rules page</a> for more on"
+ " predeclared outputs.<p>The value of this argument is either a dictionary or"
+ " a callback function that produces a dictionary. The callback works similar"
+ " to computed dependency attributes: The function's parameter names are"
@@ -293,8 +293,8 @@
doc =
"Whether this rule is considered executable, that is, whether it may be the subject"
+ " of a <code>blaze run</code> command. See the <a"
- + " href='$STARLARK_DOCS_ROOT/rules.html#executable-rules-and-test-rules'>Rules"
- + " page</a> for more information."),
+ + " href='https://bazel.build/rules/rules#executable_rules_and_test_rules'>"
+ + " Rules page</a> for more information."),
@Param(
name = "output_to_genfiles",
named = true,
@@ -381,7 +381,7 @@
"If true, then this rule is treated as an analysis test. <p>Note: Analysis test"
+ " rules are primarily defined using infrastructure provided in core Starlark"
+ " libraries. See <a"
- + " href=\"$STARLARK_DOCS_ROOT/testing.html#for-testing-rules\">Testing</a> for"
+ + " href=\"https://bazel.build/rules/testing#testing-rules\">Testing</a> for"
+ " guidance. <p>If a rule is defined as an analysis test rule, it becomes"
+ " allowed to use configuration transitions defined using <a"
+ " href=\"#analysis_test_transition\">analysis_test_transition</a> on its"
@@ -492,7 +492,7 @@
name = "aspect",
doc =
"Creates a new aspect. The result of this function must be stored in a global value."
- + " Please see the <a href=\"$STARLARK_DOCS_ROOT/aspects.md\">introduction to"
+ + " Please see the <a href=\"https://bazel.build/rules/aspects\">introduction to"
+ " Aspects</a> for more details.",
parameters = {
@Param(
diff --git a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/config/ConfigGlobalLibraryApi.java b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/config/ConfigGlobalLibraryApi.java
index dd2a813..d66447e 100644
--- a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/config/ConfigGlobalLibraryApi.java
+++ b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/config/ConfigGlobalLibraryApi.java
@@ -44,7 +44,7 @@
+ " inputs = [\"//command_line_option:cpu\"],\n"
+ " outputs = [\"//command_line_option:compilation_mode\"],\n"
+ ")</pre></p><p>For more details see <a"
- + " href=\"$STARLARK_DOCS_ROOT/config.html#user-defined-transitions\">here</a>.</p>",
+ + " href=\"https://bazel.build/rules/config#user-defined-transitions\">here</a>.</p>",
parameters = {
@Param(
name = "implementation",
@@ -107,7 +107,7 @@
+ " using this function are limited in potential scope as compared to transitions"
+ " created using <a href=\"transition.html\">transition</a>. <p>This function is"
+ " primarily designed to facilitate the <a"
- + " href=\"$STARLARK_DOCS_ROOT/testing.html\">Analysis Test Framework</a> core"
+ + " href=\"https://bazel.build/rules/testing\">Analysis Test Framework</a> core"
+ " library. See its documentation (or its implementation) for best practices.",
parameters = {
@Param(
diff --git a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/core/TransitiveInfoCollectionApi.java b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/core/TransitiveInfoCollectionApi.java
index 3917b46..f20317c 100644
--- a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/core/TransitiveInfoCollectionApi.java
+++ b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/core/TransitiveInfoCollectionApi.java
@@ -25,7 +25,7 @@
doc =
"The BUILD target for a dependency. Appears in the fields of <code><a"
+ " href='ctx.html#attr'>ctx.attr</a></code> corresponding to <a"
- + " href='$STARLARK_DOCS_ROOT/rules.html#dependency-attributes'>dependency"
+ + " href='https://bazel.build/rules/rules#dependency_attributes'>dependency"
+ " attributes</a> (<code><a href='attr.html#label'>label</a></code> or <code><a"
+ " href='attr.html#label_list'>label_list</a></code>). Has the following fields:\n"
//
@@ -46,7 +46,7 @@
+ "applied to this target.</li>\n" //
//
+ "<li><h3 id='modules.Target.providers'>Providers</h3>\n" //
- + "The <a href='$STARLARK_DOCS_ROOT/rules.html#providers'>providers</a> of a rule"
+ + "The <a href='https://bazel.build/rules/rules#providers'>providers</a> of a rule"
+ " target can be accessed by type using index notation"
+ " (<code>target[DefaultInfo]</code>). The presence of providers can be checked using"
+ " the <code>in</code> operator (<code>SomeInfo in target</code>).<br/>\n" //
@@ -56,7 +56,7 @@
+ " href='Provider.html'>Provider</a></code> instances, the struct's fields can be"
+ " accessed via the corresponding fields of the <code>Target</code>"
+ " (<code>target.some_legacy_info</code>). This behavior <a"
- + " href='$STARLARK_DOCS_ROOT/rules.html#migrating-from-legacy-providers'>is"
+ + " href='https://bazel.build/rules/rules#migrating_from_legacy_providers'>is"
+ " deprecated</a>.</li>\n" //
+ "</ul>")
public interface TransitiveInfoCollectionApi extends StarlarkValue {}
diff --git a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/test/InstrumentedFilesInfoApi.java b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/test/InstrumentedFilesInfoApi.java
index 1ddf451..03f8cad 100644
--- a/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/test/InstrumentedFilesInfoApi.java
+++ b/src/main/java/com/google/devtools/build/lib/starlarkbuildapi/test/InstrumentedFilesInfoApi.java
@@ -29,7 +29,7 @@
+ " targets matched by <a"
+ " href=\"https://bazel.build/reference/command-line-reference#flag--instrumentation_filter\"><code>--instrumentation_filter</code></a>"
+ " for purposes of <a"
- + " href=\"$STARLARK_DOCS_ROOT/rules.html#code-coverage-instrumentation\">code coverage"
+ + " href=\"https://bazel.build/rules/rules#code_coverage\">code coverage"
+ " data collection</a>. When coverage data collection is enabled, a manifest"
+ " containing the combined paths in <a"
+ " href=\"#instrumented_files\"><code>instrumented_files</code></a> and <a"
@@ -37,7 +37,7 @@
+ " action as inputs, with the manifest's path noted in the environment variable"
+ " <code>COVERAGE_MANIFEST</code>. The metadata files, but not the source files, are"
+ " also passed to the test action as inputs. When <code>InstrumentedFilesInfo</code>"
- + " is returned by an <a href=\"$STARLARK_DOCS_ROOT/aspects.html\">aspect</a>'s"
+ + " is returned by an <a href=\"https://bazel.build/rules/aspects\">aspect</a>'s"
+ " implementation function, any <code>InstrumentedFilesInfo</code> from the base rule"
+ " target is ignored.")
public interface InstrumentedFilesInfoApi extends StructApi {
