doc: default to ignoring warning during doc build

Add new target doc-strict for development to detect warnings, but avoid
failing package builds due to documentation warnings.

diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index d38c88c74e65f67ad726d0834247de40ef01207f..12406a3fb2cc3a5769c39f25ef6b0d12dc1f47e0 100644 (file)
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -180,7 +180,7 @@ doc:
   start_in: '30 seconds'
   script:
     - meson build_doc -Ddoc=enabled
-    - ninja -C build_doc doc
+    - ninja -C build_doc doc-strict
   artifacts:
     expire_in: 6 hour
     paths:

diff --git a/doc/meson.build b/doc/meson.build
index 02d8714744b500ef6b7820238644dd8b76733121..cfb5a55e419b949978968f0c546bdb62724be887 100644 (file)
--- a/doc/meson.build
+++ b/doc/meson.build
@@ -61,3 +61,9 @@ run_target(
   'doc',
   command: make_doc,
 )
+
+
+run_target(
+  'doc-strict',
+  command: [make_doc, '-W'],
+)

diff --git a/scripts/make-doc.sh b/scripts/make-doc.sh
index e5b86eb30c1b29abb1c847764f5e82c754689648..9d47612180cc7c0d50d4413a1b1f5b776dba6c14 100755 (executable)
--- a/scripts/make-doc.sh
+++ b/scripts/make-doc.sh
@@ -14,4 +14,4 @@ fi
 set -o errexit -o nounset
 
 rm -rf doc/html
-${SPHINX} -W -b html -d doc/.doctrees doc doc/html
+${SPHINX} ${@} -b html -d doc/.doctrees doc doc/html