From 725f5cd358b2a3906a1922017fa424666a972758 Mon Sep 17 00:00:00 2001 From: eldritch horrors Date: Mon, 8 Apr 2024 21:44:40 +0200 Subject: docs: redo content generation for mdbook and manual manpages can be rendered using the markdown output of mdbook, the rest of the manual can generated out of the main doc/manual source tree. we still use lowdown to actually render manpages instead of eg mdbook-man because lowdown does generate reasonably good manpages (though that is also somewhat debatable, but they're a lot better than mdbook-man). doing this not only lets us drastically simplify the lowdown pipeline, but also remove all custom {{#include}} handling since now mdbook does all of it, even for the manpage builds. even the lowdown wrapper isn't entirely necessary because lowdown can take all wrapper arguments with command line flags rather than bits of input file content. This also implements running mdbook in Meson, in order to generate the manpages. The mdbook outputs are also installed in the usual location. Co-authored-by: Qyriad Change-Id: I60193f9fd0f15d48872f071af35855cda2a0f40b --- meson.build | 4 ++++ 1 file changed, 4 insertions(+) (limited to 'meson.build') diff --git a/meson.build b/meson.build index 22739a4ab..bc55c64c4 100644 --- a/meson.build +++ b/meson.build @@ -258,6 +258,10 @@ dot = find_program('dot', required : false) pymod = import('python') python = pymod.find_installation('python3') +if enable_docs + mdbook = find_program('mdbook') +endif + # Used to workaround https://github.com/mesonbuild/meson/issues/2320 in src/nix/meson.build. installcmd = find_program('install') -- cgit v1.2.3