fix most doc warnings

2024-07-10 23:36:24 +01:00
parent 57e3b449f8
commit 3f8cc24dcc
11 changed files with 23 additions and 14 deletions
--- a/doc/hardware.nix
+++ b/doc/hardware.nix
@@ -7,11 +7,15 @@ let
    n:
    let
      d = import ../devices/${n}/default.nix;
+      tag = ".. _${lib.strings.replaceStrings [" "] ["-"] n}:";
      d' = {
-        description = "${n}\n${substring 0 (stringLength n) "********************************"}\n";
+        description = ''
+          ${n}
+          ${substring 0 (stringLength n) "********************************"}
+        '';
      } // d;
    in
-    d'.description
+      "${tag}\n\n${d'.description}"
  ) devices;
 in
 writeText "hwdoc" ''