puck/zilch
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: Generate manpages from docs, use in CLI

Browse source 
Change-Id: I6a6a69646c6ff4c4b70cb928dc1df06890144429
This commit is contained in:
puck 2025-06-23 12:22:20 +00:00
parent 5332df82bb
commit 30814de5e4
4 changed files with 26 additions and 45 deletions
Download patch file Download diff file Expand all files Collapse all files

13
docs/manpages.nix Normal file
View file

@ -0,0 +1,13 @@
{ pkgs, asciidoctor, groff, ... }: let
generateManpage = name: file: pkgs.runCommandNoCC name {} ''
${asciidoctor}/bin/asciidoctor -b manpage -o $out ${file}
'';
textifyManpage = name: manpage: pkgs.runCommandNoCC name {} ''
${groff}/bin/groff -t -e -mandoc -Tascii ${manpage} > $out
'';
generateBoth = name: file: rec { man = generateManpage name file; txt = textifyManpage "${name}.txt" man; };
in {
rust = generateBoth "zilch-cli-rust.1" ./modules/ROOT/pages/rust/man.adoc;
go = generateBoth "zilch-cli-go.1" ./modules/ROOT/pages/go/man.adoc;
}