support links from device pages to their installation methods

ci.nix

@@ -59,7 +59,7 @@ let
           installPhase = ''
             mkdir -p $out/nix-support $out/share/doc/
             cd doc
-            cp modules-generated.rst  $out
+            cp *-generated.rst  $out
             ln -s ${json} $out/options.json
             cp -a _build/html $out/share/doc/liminix
             echo "file source-dist \"$out/share/doc/liminix\"" \

devices/gl-ar750/default.nix

@@ -6,7 +6,7 @@
 # Mainline linux 5.19 doesn't have device-tree support for this device
 # or even for the SoC, so we use the extensive OpenWrt kernel patches
 
-{
+rec {
   system = {
     crossSystem = {
       config = "mips-unknown-linux-musl";
@@ -51,6 +51,7 @@
     OpenWrt web page: https://openwrt.org/toh/gl.inet/gl-ar750
 
   '';
+  installer = "flashimage";
 
   module = {pkgs, config, ... }:
     let
@@ -102,7 +103,7 @@
         FEATURE_DD_IBS_OBS = "y"; # ath10k_cal_data needs skip_bytes,fullblock
       };
       hardware = {
-        defaultOutput = "flashimage";
+        defaultOutput = installer;
         loadAddress = "0x80060000";
         entryPoint  = "0x80060000";
         flash = {

doc/hardware.nix

@@ -5,8 +5,18 @@ let
     builtins.readDir ../devices;
   texts = lib.mapAttrsToList (n: t:
     let d = import  ../devices/${n}/default.nix;
-        d' = { description = "no description for ${n}"; } // d;
-    in d'.description )
+        d' = {
+          description = "no description for ${n}";
+        } // d;
+        installer =
+          if d ? installer
+          then ''
+
+            The default installation route for this device is
+            :ref:`system-outputs-${d.installer}`
+          ''
+          else "";
+    in (d'.description + installer))
     devices;
 in
 writeText "hwdoc" ''

doc/parse-options-outputs.fnl

@@ -7,5 +7,5 @@
 
 (each [_ option (ipairs (yaml.load (io.read "*a")))]
   (when (. outputs option.name)
-    (print (.. ".. _" option.name) "\n")
+    (print (.. ".. _" (string.gsub option.name "%." "-") ":") "\n")
     (print option.description)))