[libcamera-devel] [PATCH] Documentation: Add linkcheck target

[Kieran Bingham]

Sphinx provides a run-target to verify external links specified in the
documentation. This requires an active connection to be able to validate
the links.

Add a meson target to integrate the linkcheck facility into our build
and test system.

This rule does not run by default, but can be called with:

  ninja Documentation/linkcheck

Signed-off-by: Kieran Bingham <kieran.bingham at ideasonboard.com>
---
 Documentation/meson.build | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/Documentation/meson.build b/Documentation/meson.build
index dd43b2cbd401..cf91202224db 100644
--- a/Documentation/meson.build
+++ b/Documentation/meson.build
@@ -55,4 +55,9 @@ if sphinx.found()
                   build_by_default: true,
                   install: true,
                   install_dir: doc_install_dir)
+
+    custom_target('documentation-linkcheck',
+                  command: [sphinx, '-W', '-b', 'linkcheck', meson.current_source_dir(), '@OUTPUT@'],
+                  input: docs_sources,
+                  output: 'linkcheck')
 endif
-- 
2.17.1