Bazel Docs: Fix broken links
$DOC_EXT has been deprecated some time ago. For the Starlark lib it's ok to use the ".html" extension in links, since it works both internally and externally (although the external system prefers links without any file extension at all).
@@ -70,7 +70,7 @@ public interface StarlarkAttrModuleApi extends StarlarkValue {
String OUTPUT_ATTR_TEXT =
LABEL_PARAGRAPH
+ "<p>At analysis time, the corresponding <a href='File.html'><code>File</code></a> can "
- + "be retrieved using <a href='../ctx.$DOC_EXT#outputs'><code>ctx.outputs</code></a>.";
+ + "be retrieved using <a href='ctx.html#outputs'><code>ctx.outputs</code></a>.";
String ALLOW_FILES_ARG = "allow_files";
String ALLOW_FILES_DOC =
@@ -151,8 +151,8 @@ public interface StarlarkAttrModuleApi extends StarlarkValue {
doc =
"Creates a schema for an integer attribute. The value must be in the signed 32-bit"
+ " range. The corresponding "
- + "<a href='../ctx.$DOC_EXT#attr'><code>ctx.attr</code></a> attribute will be of "
- + "type <a href='../int.$DOC_EXT'><code>int</code></a>.",
+ + "<a href='ctx.html#attr'><code>ctx.attr</code></a> attribute will be of "
+ + "type <a href='int.html'><code>int</code></a>.",
parameters = {
@Param(
name = DEFAULT_ARG,
@@ -191,7 +191,7 @@ public interface StarlarkAttrModuleApi extends StarlarkValue {
@StarlarkMethod(
name = "string",
- doc = "Creates a schema for a <a href='../string.$DOC_EXT#attr'>string</a> attribute.",
+ doc = "Creates a schema for a <a href='string.html#attr'>string</a> attribute.",
parameters = {
@Param(
name = DEFAULT_ARG,
@@ -420,9 +420,9 @@ public interface StarlarkAttrModuleApi extends StarlarkValue {
name = "label_list",
doc =
"<p>Creates a schema for a list-of-labels attribute. This is a dependency attribute. "
- + "The corresponding <a href='../ctx.$DOC_EXT#attr'><code>ctx.attr</code></a> "
- + "attribute will be of type <a href='../list.$DOC_EXT'>list</a> of "
- + "<a href='Target.$DOC_EXT'><code>Target</code>s</a>.</p>"
+ + "The corresponding <a href='ctx.html#attr'><code>ctx.attr</code></a> "
+ + "attribute will be of type <a href='list.html'>list</a> of "
+ + "<a href='Target.html'><code>Target</code>s</a>.</p>"
+ DEPENDENCY_ATTR_TEXT,
parameters = {
@Param(name = ALLOW_EMPTY_ARG, defaultValue = "True", doc = ALLOW_EMPTY_DOC, named = true),
@@ -617,8 +617,8 @@ public interface StarlarkAttrModuleApi extends StarlarkValue {
name = "bool",
doc =
"Creates a schema for a boolean attribute. The corresponding <a"
- + " href='../ctx.$DOC_EXT#attr'><code>ctx.attr</code></a> attribute will be of type"
- + " <a href='../bool.$DOC_EXT'><code>bool</code></a>.",
+ + " href='ctx.html#attr'><code>ctx.attr</code></a> attribute will be of type"
+ + " <a href='bool.html'><code>bool</code></a>.",
parameters = {
@Param(
name = DEFAULT_ARG,
