Bug#968975: glib2.0: FTBFS in experimental fails doc-test on glib

[Simon McVittie]

On Mon, 24 Aug 2020 at 23:44:35 +0100, Dimitri John Ledkov wrote:
> I am observing in experimental & groovy-proposed
> 
> 271/273 glib / gio-doc-check                            OK             0.07s
> Running suite(s): gtk-doc-glib
> glib-unused.txt:1:E: 36 unused documentation entries
> 
> 75.0%: Checks 4, Failures: 1
> 272/273 glib / glib-doc-check                           FAIL           0.07s (exit status 1)

I think this might mean we need a newer snapshot of gtk-doc with more
bugs fixed. I've been trying to get upstream closer to making an actual
release of gtk-doc.

Unfortunately we also need a special branch of gtk-doc to be able to
build gtk+4.0, and there's only one experimental, so we can't have two
different gtk-doc versions in it. My next step on that when I have time
will probably be to bundle a copy of the GTK 4 branch of gtk-doc into
gtk+4.0 for now, and use that for its build, to decouple it from the
rest of the GTK/GNOME ecosystem.

Disabling the gtk-doc completeness check would be a possible stopgap
solution, although that'll mean the HTML documentation is incomplete.

    smcv