docs: generate individual command man pages during build

Add build rules to dynamically generate man pages for each grcli command
by invoking 'grcli --man <command>'. The list of commands is hardcoded
in meson.build since meson cannot execute the compiled binary during
the configuration phase.

Update packaging files (under debian and rpm) to include all generated
grcli man pages.

Assisted-by: Cursor/Claude-4-Sonnet
Signed-off-by: Abhiram R N <[email protected]>

Author: abhiramnarayana

debian/grout.install

@@ -5,5 +5,5 @@
 /usr/lib/systemd/system/grout.service
 /usr/share/bash-completion/completions/grcli
 /usr/share/bash-completion/completions/grout
-/usr/share/man/man1/grcli.1
+/usr/share/man/man1/grcli*.1
 /usr/share/man/man8/grout.8

docs/meson.build

@@ -67,3 +67,32 @@ custom_target(
   install_dir: '@0@/man1'.format(mandir),
   install_tag: 'man',
 )
+
+# Individual command man pages
+# The list is hardcoded since we can't run grcli during meson configuration.
+grcli_commands = [
+  'address', 'affinity', 'conntrack', 'dnat44', 'events',
+  'graph', 'interface', 'logging', 'nexthop', 'ping',
+  'quit', 'route', 'router-advert', 'snat44', 'stats',
+  'trace', 'traceroute', 'tunsrc',
+]
+
+foreach cmd : grcli_commands
+  cmd_md = custom_target(
+    'grcli-@[email protected]'.format(cmd),
+    output: 'grcli-@[email protected]'.format(cmd),
+    command: [grcli_exe, '--man', cmd],
+    capture: true,
+  )
+  custom_target(
+    'grcli-@[email protected]'.format(cmd),
+    input: cmd_md,
+    output: 'grcli-@[email protected]'.format(cmd),
+    command: md2man,
+    install: true,
+    feed: true,
+    capture: true,
+    install_dir: '@0@/man1'.format(mandir),
+    install_tag: 'man',
+  )
+endforeach

rpm/grout.spec

@@ -100,7 +100,7 @@ install -D -m 0644 -t %{buildroot}%{_datadir}/dpdk/telemetry-endpoints subprojec
 %attr(644, root, root) %{_datadir}/bash-completion/completions/grcli
 %attr(755, root, root) %{_bindir}/grcli
 %attr(755, root, root) %{_bindir}/grout
-%attr(644, root, root) %{_mandir}/man1/grcli.1*
+%attr(644, root, root) %{_mandir}/man1/grcli*.1*
 %attr(644, root, root) %{_mandir}/man8/grout.8*
 
 %files devel