Merge branch 'doxygen-warn-as-err/1' into 'master'

doc: Doxyfile.in: trigger error on warning

See merge request videolan/vlc!3893

doc/Doxyfile.in

@@ -723,6 +723,7 @@ WARN_IF_UNDOCUMENTED   = YES
 # The default value is: YES.
 
 WARN_IF_DOC_ERROR      = YES
+WARN_AS_ERROR          = YES
 
 # This WARN_NO_PARAMDOC option can be enabled to get warnings for functions that
 # are documented, but have no documentation for their parameters or return

extras/ci/gitlab-ci.yml

@@ -1,4 +1,5 @@
 stages:
+    - lint
     - build
 
 default:
@@ -249,6 +250,36 @@ nightly-win64-arm-llvm:
         # branch protection enabled on Windows.
         CONFIGFLAGS: --disable-branch-protection
 
+doc:
+    stage: lint
+    rules:
+        - if: $CI_MERGE_REQUEST_IID
+        - if: '$CI_PIPELINE_SOURCE == "push" && $CI_PROJECT_PATH == "videolan/vlc"'
+    image:
+        name: $VLC_DEBIAN_IMAGE
+    script: |
+        echo "Building branch '${CI_COMMIT_BRANCH}' (default: '${CI_DEFAULT_BRANCH}')"
+
+        # Configure VLC
+        ./bootstrap
+        ./configure --disable-a52 \
+	        --disable-alsa \
+	        --disable-avcodec --disable-avformat \
+	        --disable-postproc --disable-swscale \
+	        --disable-dbus \
+	        --disable-mad --disable-libmpeg2 \
+	        --disable-faad --disable-skins2 \
+	        --disable-live555 \
+	        --disable-lua \
+	        --disable-fribidi \
+	        --with-kde-solid='$${datadir}/kde4/apps'
+
+        # Build documentation
+        make doc
+    variables:
+        <<: *variables-debian
+
+
 #
 # Debian
 #