From: Emil Velikov <emil.l.velikov@gmail.com>
Date: Fri, 6 Sep 2024 16:45:21 +0000 (-0500)
Subject: ci: build: add docs in ci/developer builds
X-Git-Tag: v34~417
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=01bea70795950b9a2bb52e8967a85dac63ca0f91;p=thirdparty%2Fkmod.git

ci: build: add docs in ci/developer builds

To make it a little bit more obvious that those should be updated as
well...

On Alpine it fails (as below), so we've disabled it for now.

When gtkdoc-mkhtml calls xsltproc, the latter throws dozens of errors and
fails to produce the libkmod.devhelp2 file. Which meson tries to move
and fails.

  Error: no ID for constraint linkend: "int"

Signed-off-by: Emil Velikov <emil.l.velikov@gmail.com>
Link: https://github.com/kmod-project/kmod/pull/94
Signed-off-by: Lucas De Marchi <lucas.de.marchi@gmail.com>
---

diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
index af503034..7c239f74 100644
--- a/.github/workflows/main.yml
+++ b/.github/workflows/main.yml
@@ -23,6 +23,7 @@ jobs:
           - name: 'archlinux:base-devel'
           - name: 'fedora:latest'
           - name: 'alpine:latest'
+            meson_setup: '-D docs=false'
           - name: 'debian:unstable'
 
     container:
@@ -69,7 +70,7 @@ jobs:
 
       - name: configure (meson)
         if: ${{ matrix.build == 'meson' }}
-        run: mkdir build && cd build && meson setup --native-file ../build-dev.ini . ..
+        run: mkdir build && cd build && meson setup --native-file ../build-dev.ini ${{ matrix.container.meson_setup }} . ..
 
       - name: configure (autotools)
         if: ${{ matrix.build == 'autotools' }}
diff --git a/autogen.sh b/autogen.sh
index 95c65447..5b60888e 100755
--- a/autogen.sh
+++ b/autogen.sh
@@ -27,6 +27,7 @@ cd $oldpwd
 
 hackargs="\
 --enable-debug \
+--enable-gtk-doc \
 --with-zstd \
 --with-xz \
 --with-zlib \
diff --git a/build-dev.ini b/build-dev.ini
index 39acced1..1f8352b4 100644
--- a/build-dev.ini
+++ b/build-dev.ini
@@ -1,6 +1,7 @@
 [project options]
 build-tests = true
 debug-messages = true
+docs = true
 zstd = 'enabled'
 xz = 'enabled'
 zlib = 'enabled'