From: Tomas Krizek <tomas.krizek@nic.cz>
Date: Wed, 1 Jul 2020 11:26:23 +0000 (+0200)
Subject: doc: default to ignoring warning during doc build
X-Git-Tag: v5.1.2^2~1
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=2a0fb999112d9b18570b3e6a336cdfee5ec9f5d5;p=thirdparty%2Fknot-resolver.git

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 d38c88c74..12406a3fb 100644
--- 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 02d871474..cfb5a55e4 100644
--- 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 e5b86eb30..9d4761218 100755
--- 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