ci: scope the documentation check to this file, and install graphviz

The htmldocs step failed on its own success criterion. The only diagnostic
in the log was

  WARNING: dot(1) not found, for better output quality install graphviz

which says nothing about this patch. Failing the job on any occurrence of
"warning" anywhere in a kernel documentation build is too blunt: that build
emits diagnostics that depend on what happens to be installed on the runner.

Install graphviz so the warning is gone for the right reason, and narrow the
check to diagnostics that actually name i2c-imc-skylake, which is what the
step was meant to verify.
This commit is contained in:
Simone
2026-07-27 00:16:42 +02:00
parent 5f97a71ad2
commit 77452d5697
+8 -2
View File
@@ -129,10 +129,16 @@ jobs:
- name: Build the documentation
working-directory: linux-i2c
run: |
sudo apt-get install -y python3-sphinx python3-sphinx-rtd-theme
sudo apt-get install -y graphviz python3-sphinx python3-sphinx-rtd-theme
cp ../docs/submission/i2c-imc-skylake.rst Documentation/i2c/busses/
sed -i 's|^ i2c-i801$| i2c-i801\n i2c-imc-skylake|' \
Documentation/i2c/busses/index.rst
grep -q i2c-imc-skylake Documentation/i2c/busses/index.rst
make O=../linux-out htmldocs SPHINXDIRS=i2c 2>&1 | tee doc.log | tail -20
! grep -Ei 'WARNING|ERROR' doc.log
# Only diagnostics naming this file should fail the job. The docs
# build emits environment-dependent warnings that say nothing about
# this patch.
if grep -Ei 'warning|error' doc.log | grep -i i2c-imc-skylake; then
echo "the documentation build complained about this file" >&2
exit 1
fi