Bug#850232: installation-guide: FTBFS randomly (ERROR: xref linking to appendix-gpl has no generated link text.)

[Santiago Vila <sanvila@debian.org>]

Package: src:installation-guide
Version: 20161031
Severity: important

Dear maintainer:

I tried to build this package in stretch with "dpkg-buildpackage -A"
(which is what the "Arch: all" autobuilder would do to build it)
but it failed:

--------------------------------------------------------------------------------
[...]
 debian/rules build-indep
rm -f build-stamp
rm -rf /<<PKGBUILDDIR>>/debian/manual
set -e && cd build && \
	MAKEFLAGS="-j1" \
	official_build=1 manual_release=wheezy \
	architectures="i386 amd64 arm64 armel armhf mips mips64el mipsel ppc64el s390x" languages="en cs da de el es fr it ja ko pt ru sv vi zh_CN" \
	destination=/<<PKGBUILDDIR>>/debian/manual/'${arch}' noarchdir=1 \
	./build.sh
Generating integrated XML files and POT files
Building list of entities...
Converting XML files to UTF-8...
Merging XML files per 'chapter'...

[... snipped ...]

Writing build.out.da.i386/html/apas01.html for sect1(howto-preliminaries)
Writing build.out.da.i386/html/apas02.html for sect1(howto-getting-images)
Writing build.out.da.i386/html/apas03.html for sect1(howto-installation)
Writing build.out.da.i386/html/apas04.html for sect1(howto-installation-report)
Writing build.out.da.i386/html/apas05.html for sect1(howto-installation-finally)
Writing build.out.da.i386/html/apa.html for appendix(installation-howto)
Writing build.out.da.i386/html/apbs01.html for sect1(preseed-intro)
Writing build.out.da.i386/html/apbs02.html for sect1(preseed-using)
Writing build.out.da.i386/html/apbs03.html for sect1(preseed-creating)
Writing build.out.da.i386/html/apbs04.html for sect1(preseed-contents)
Writing build.out.da.i386/html/apbs05.html for sect1(preseed-advanced)
Writing build.out.da.i386/html/apb.html for appendix(appendix-preseed)
Writing build.out.da.i386/html/apcs01.html for sect1(partition-sizing)
Writing build.out.da.i386/html/apcs02.html for sect1(directory-tree)
Writing build.out.da.i386/html/apcs03.html for sect1
Writing build.out.da.i386/html/apcs04.html for sect1(device-names)
Writing build.out.da.i386/html/apcs05.html for sect1(partition-programs)
Writing build.out.da.i386/html/apc.html for appendix(partitioning)
Writing build.out.da.i386/html/apds01.html for sect1(linuxdevices)
Writing build.out.da.i386/html/apds02.html for sect1(tasksel-size-list)
Writing build.out.da.i386/html/apds03.html for sect1(linux-upgrade)
Writing build.out.da.i386/html/apds04.html for sect1(plip)
Writing build.out.da.i386/html/apds05.html for sect1(pppoe)
Writing build.out.da.i386/html/apd.html for appendix(random-bits)
Writing build.out.da.i386/html/apes01.html for sect1(about)
Writing build.out.da.i386/html/apes02.html for sect1(contributing)
Writing build.out.da.i386/html/apes03.html for sect1(contributors)
Writing build.out.da.i386/html/apes04.html for sect1(trademarks)
Writing build.out.da.i386/html/ape.html for appendix(administrivia)
Writing build.out.da.i386/html/index.html for book
Info: creating temporary .tex file...
openjade:build.tmp.da.i386/install.da.profiled.xml:32:178:X: reference to non-existent ID "appendix-gpl"
openjade:/usr/share/sgml/docbook/stylesheet/dsssl/modular/print/dblink.dsl:200:1:E: XRef LinkEnd to missing ID 'appendix-gpl'
Error: build of pdf failed with error code 1
Info: creating temporary .html file...
ERROR: xref linking to appendix-gpl has no generated link text.
Error: no ID for constraint linkend: "appendix-gpl".
Info: creating .txt file...
Warning: The following formats failed to build: pdf
Makefile:8: recipe for target 'da.i386' failed
make[1]: *** [da.i386] Error 2
make[1]: Leaving directory '/<<PKGBUILDDIR>>/build'
debian/rules:60: recipe for target 'build-stamp' failed
make: *** [build-stamp] Error 2
dpkg-buildpackage: error: debian/rules build-indep gave error exit status 2
--------------------------------------------------------------------------------

This is just how the build ends, not necessarily the relevant part.

I've put several build logs here:

https://people.debian.org/~sanvila/build-logs/installation-guide/

If this is really a bug in one of the build-depends, please use reassign and affects,
so that this is still visible in the page for this package.

The bug should be reproducible with sbuild on a single CPU virtual machine,
provided you try enough times (as the failure happens randomly).

Thanks.