Update stardoc to v0.8.0

GitOrigin-RevId: 11496f6ba52aa4ac684f2f293dad2162d3e1c937

Author: jmillikin

.github/workflows/tests.yaml

@@ -43,6 +43,8 @@ jobs:
           chmod +x "cache/bazel-${BAZEL_VERSION}-linux-x86_64"
           mkdir -p src/tools
           ln -s "../../cache/bazel-${BAZEL_VERSION}-linux-x86_64" src/tools/bazel
+
+          echo 'tools/stardoc' > src/.bazelignore
         env:
           BAZEL_VERSION: ${{ matrix.bazel.version }}
       - name: "bazel test //..."

MODULE.bazel

@@ -19,7 +19,7 @@ bazel_dep(
 )
 bazel_dep(
     name = "stardoc",
-    version = "0.5.3",
+    version = "0.8.0",
     dev_dependency = True,
     repo_name = "io_bazel_stardoc",
 )

WORKSPACE

@@ -47,9 +47,9 @@ http_archive(
 
 http_archive(
     name = "io_bazel_stardoc",
-    sha256 = "3fd8fec4ddec3c670bd810904e2e33170bedfe12f90adf943508184be458c8bb",
+    sha256 = "ca933f39f2a6e0ad392fa91fd662545afcbd36c05c62365538385d35a0323096",
     urls = [
-        "https://mirror.bazel.build/github.com/bazelbuild/stardoc/releases/download/0.5.3/stardoc-0.5.3.tar.gz",
-        "https://github.com/bazelbuild/stardoc/releases/download/0.5.3/stardoc-0.5.3.tar.gz",
+        "https://mirror.bazel.build/github.com/bazelbuild/stardoc/releases/download/0.8.0/stardoc-0.8.0.tar.gz",
+        "https://github.com/bazelbuild/stardoc/releases/download/0.8.0/stardoc-0.8.0.tar.gz",
     ],
 )

docs/rules_flex.md

@@ -1,9 +1,14 @@
 load("//flex/internal:toolchain_alias.bzl", "flex_toolchain_alias")
 
+filegroup(
+    name = "flex_bzl",
+    srcs = ["flex.bzl"],
+    visibility = ["//:__subpackages__"],
+)
+
 filegroup(
     name = "bzl_srcs",
     srcs = glob(["*.bzl"]) + [
-        "//flex/extensions:bzl_srcs",
         "//flex/internal:bzl_srcs",
         "//flex/rules:bzl_srcs",
     ],

flex/BUILD

@@ -1,5 +1,5 @@
 filegroup(
-    name = "bzl_srcs",
-    srcs = glob(["*.bzl"]),
+    name = "flex_repository_ext_bzl",
+    srcs = ["flex_repository_ext.bzl"],
     visibility = ["//:__subpackages__"],
 )

flex/extensions/BUILD

@@ -1,35 +1,41 @@
-load("@bazel_skylib//:bzl_library.bzl", "bzl_library")
 load("@io_bazel_stardoc//stardoc:stardoc.bzl", "stardoc")
 
-bzl_library(
-    name = "rules_flex_bzl_srcs",
-    srcs = ["//flex:bzl_srcs"],
+stardoc(
+    name = "flex_md",
+    out = "flex.md",
+    header_template = ":header.vm",
+    input = "//flex:flex_bzl",
+    deps = ["//flex:bzl_srcs"],
 )
 
 stardoc(
-    name = "rules_flex_raw_md",
-    out = "rules_flex_raw.md",
-    input = "rules_flex_md.bzl",
-    deps = [":rules_flex_bzl_srcs"],
+    name = "flex_repository_ext_md",
+    out = "flex_repository_ext.md",
+    header_template = ":empty.vm",
+    input = "//flex/extensions:flex_repository_ext_bzl",
+    deps = ["//flex:bzl_srcs"],
 )
 
 # https://github.com/bazelbuild/stardoc/issues/78
 genrule(
     name = "rules_flex_md",
-    srcs = [":rules_flex_raw.md"],
+    srcs = [
+        ":flex_md",
+        ":flex_repository_ext_md",
+    ],
     outs = ["rules_flex.md"],
     cmd = """
-sed \\
+cat $(SRCS) | sed \\
   -e 's/C or C++ mode:/C or C++ mode:<ul>/g' \\
   -e 's/  - \\([^-]*\\)  /<li>\\1<\\/li>  /' \\
   -e 's/  - \\([^-]*\\)  /<li>\\1<\\/li>  /' \\
   -e 's/<br><br>The C++ output/<\\/ul>The C++ output/g' \\
-  $< > $@
+  > $@
 """,
 )
 
 filegroup(
     name = "stardoc_outputs",
-    srcs = [":rules_flex.md"],
+    srcs = [":rules_flex_md"],
     visibility = ["//:__subpackages__"],
 )

tools/stardoc/BUILD

@@ -0,0 +1,5 @@
+<!-- Generated with Stardoc: http://skydoc.bazel.build -->
+
+# rules_flex
+
+${moduleDocstring}