document installation methods (only vmroot yet)

This commit is contained in:
Daniel Barlow 2023-11-09 22:12:29 +00:00
parent 7d5c7b9b44
commit 5729cfb4a7
4 changed files with 21 additions and 0 deletions

1
ci.nix
View file

@ -47,6 +47,7 @@ let
src = ./.;
buildPhase = ''
cat ${json} | fennel --correlate doc/parse-options.fnl > doc/modules-generated.rst
cat ${json} | fennel --correlate doc/parse-options-outputs.fnl system.outputs.vmroot > doc/installers-generated.rst
cp ${(import ./doc/hardware.nix)} doc/hardware.rst
make -C doc html
'';

View file

@ -12,6 +12,7 @@ Liminix
development
modules
hardware
installers
Indices and tables

8
doc/installers.rst Normal file
View file

@ -0,0 +1,8 @@
Installers
##########
There are a number of different routes to getting
Liminix onto devices, and which one you should use
(or are able to use) varies according to the device.
.. include:: installers-generated.rst

View file

@ -0,0 +1,11 @@
(local yaml (require :lyaml))
;; (local { : view } (require :fennel))
(local outputs (collect [k v (ipairs arg)]
(values v true)))
(each [_ option (ipairs (yaml.load (io.read "*a")))]
(when (. outputs option.name)
(print (.. ".. _" option.name) "\n")
(print option.description)))