nixpkgs/nixos/lib/make-options-doc
pennae 0175a91aa3 nixos/make-options-doc: split docbook conversion from mergeJSON
this restores mergeJSON to its former glory if…merging json, and
extracts the MD rendering into a new script that will run instead of the
py+nix+xslt pipeline we previously ran to convert options.json to docbook.

this change alone gives a noticable performance boost when building
docs (18s instead of 27s to build optionsDocBook).

no changes to rendered output, except for a single example in the
rsnapshot module that uses hard tabs for indentation instead of spaces.
this probably isn't important.

docbook warnings remain with mergeJSON since the other processing steps
output single files instead of directories. since we'll only keep the
check until 23.11 this is probably also not important to fix.

also contains a few improvements to error reporting in the MD renderers.
2023-01-26 00:32:56 +01:00
..
default.nix nixos/make-options-doc: split docbook conversion from mergeJSON 2023-01-26 00:32:56 +01:00
generateDoc.py nixos/make-options-doc: skip re-escaping strings 2023-01-08 08:52:17 +00:00
mergeJSON.py nixos/make-options-doc: split docbook conversion from mergeJSON 2023-01-26 00:32:56 +01:00
optionsToDocbook.py nixos/make-options-doc: split docbook conversion from mergeJSON 2023-01-26 00:32:56 +01:00
postprocess-option-descriptions.xsl