#1072860 dh_sphinxdoc: unable to exclude files from test with -X

#1072860#5
Date:
2024-06-09 10:57:22 UTC
From:
To:
Hi maintainers,

While migrating the developers-reference to a Debian-style html theme - based
on a readthedocs theme - we encountered a build failure with:
-----------------------------------------------------------------
debian/rules override_dh_sphinxdoc
make[1]: Entering directory '/build/developers-reference-13.7'
dh_sphinxdoc -pdevelopers-reference usr/share/developers-reference
dh_sphinxdoc: error: debian/developers-reference/usr/share/developers-reference/search.html top-level node does not have data-content_root attribute
make[1]: *** [debian/rules:19: override_dh_sphinxdoc] Error 255
make[1]: Leaving directory '/build/developers-reference-13.7'
make: *** [debian/rules:6: binary] Error 2
dpkg-buildpackage: error: debian/rules binary subprocess returned exit status 2
-----------------------------------------------------------------

While this error is basically correct (the search.html in fact does not
contain data-content_root attribute, and this because I incorrectly used the
search.html template from the python3-sphinx-rtd-theme package from stable
instead of unstable), I could not exclude the search.html from the tests with

	-Xsearch.html
or
	-Xdebian/developers-reference/usr/share/developers-reference/search.html
as stated in the manpage.

So, the exclude function seems somewhat buggy.


Thanks for your time

So long
Holger