[elbe-devel] [PATCH 6/9] docs: sphinx: build manpages with sphinx

Thomas Weißschuh thomas.weissschuh at linutronix.de
Mon Apr 8 15:08:41 CEST 2024


Sphinx has a manpage generator, use it instead of having lots of custom
logic.

Signed-off-by: Thomas Weißschuh <thomas.weissschuh at linutronix.de>
---
 docs/conf.py | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/docs/conf.py b/docs/conf.py
index 7400e85dbe2d..ee80a60f498b 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -138,12 +138,21 @@ latex_documents = [
 
 # -- Options for manual page output ---------------------------------------
 
+import elbepack.directories  # noqa: E402, I100, I202
+
 # One entry per manual page. List of tuples
 # (source start file, name, description, authors, manual section).
 man_pages = [
     (master_doc, 'elbe', u'ELBE Documentation',
      [author], 1)
 ]
+man_pages = [
+    ('elbe', 'elbe', '', [], 1),
+] + [
+    ('elbe-' + cmd, 'elbe-' + cmd, '', [], 1)
+    for cmd in elbepack.directories.get_cmdlist()
+    if cmd not in {'adjustpkgs', 'bootup-check', 'check-build', 'pin_versions'}
+]
 
 
 # -- Options for Texinfo output -------------------------------------------

-- 
2.44.0



More information about the elbe-devel mailing list