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 af503034246d37aee2483b090917ed5e4ae19ecc..7c239f749655184531abccb09b8374d39930c1f3 100644 (file)
--- 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 95c6544753f7d60616c31f03197575f3c6e44e47..5b60888e5c1ea7015f72f6343121475f06175a98 100755 (executable)
--- 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 39acced1868dfa0c529444c3e5b38652336e6dc5..1f8352b4f348c6df4440c047ba6cb49c54bd8fdb 100644 (file)
--- 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'