gtkdoc-fixxref script fails at runtime because pygments python3 module is not found
Please see jhbuild#20 (closed) for how gtkdoc-fixxref
script fails while being run by json-glib
module to build its documentation, the error is gone after installing the package for the pygments python3 module (dnf install python3-pygments
in fedora). So it seems the pygments
dependency is not being pulled in by gtk-doc
properly.
I checked the commit logs and the problem may be that 0ecfc90b or 232698c6 is lacking a pip install -r requirements.txt
somewhere, or maybe we should instead use meson to pull the python module dependency (instead of pip). Because the similar commit for autotools 7ac15e6f seems more explicit about requiring the python module being installed in the system.
This is the error (taken from the mentioned jhbuild issue):
Building documentation for json-glib
./json-glib-unused.txt:1: warning: 7 unused declarations. They should be added to json-glib-sections.txt in the appropriate place.
ERROR: Error in gtkdoc helper script:
ERROR: ['gtkdoc-fixxref', '--module=json-glib', '--module-dir=html', '--html-dir=/home/nelson/jhbuild/install/share/gtk-doc/html', '--extra-dir=/home/nelson/jhbuild/install/share/gtk-doc/html/glib', '--extra-dir=/home/nelson/jhbuild/install/share/gtk-doc/html/gobject', '--extra-dir=/home/nelson/jhbuild/install/share/gtk-doc/html/gio'] failed with status 1
Traceback (most recent call last):
File "/home/nelson/jhbuild/install/bin/gtkdoc-fixxref", line 28, in <module>
from gtkdoc import common, config, fixxref
File "/home/nelson/jhbuild/install/share/gtk-doc/python/gtkdoc/fixxref.py", line 28, in <module>
from . import common, highlight
File "/home/nelson/jhbuild/install/share/gtk-doc/python/gtkdoc/highlight.py", line 27, in <module>
from pygments import highlight
ModuleNotFoundError: No module named 'pygments'