update stardoc

Author: jmillikin

MODULE.bazel

@@ -12,14 +12,9 @@ bazel_dep(
     dev_dependency = True,
     repo_name = "com_google_googletest",
 )
-bazel_dep(
-    name = "bazel_skylib",
-    version = "1.2.1",
-    dev_dependency = True,
-)
 bazel_dep(
     name = "stardoc",
-    version = "0.5.3",
+    version = "0.8.0",
     dev_dependency = True,
     repo_name = "io_bazel_stardoc",
 )

WORKSPACE

@@ -36,20 +36,11 @@ http_archive(
     urls = ["https://github.com/google/googletest/archive/release-1.12.1.tar.gz"],
 )
 
-http_archive(
-    name = "bazel_skylib",
-    sha256 = "f7be3474d42aae265405a592bb7da8e171919d74c16f082a5457840f06054728",
-    urls = [
-        "https://mirror.bazel.build/github.com/bazelbuild/bazel-skylib/releases/download/1.2.1/bazel-skylib-1.2.1.tar.gz",
-        "https://github.com/bazelbuild/bazel-skylib/releases/download/1.2.1/bazel-skylib-1.2.1.tar.gz",
-    ],
-)
-
 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}