Bug#943421: doxygen 1.8.16 is ready for unstable, 10+ packages will FTBFS on amd64

[Paolo Greppi]

Hi Gard, see below

On 25/10/19 11:45, Gard Spreemann wrote:
> Hi,
> 
> Paolo Greppi <paolo.greppi at libpf.com> writes:
> 
>> The 10 remaining packages all fail with latex-related errors.
>> Unfortunately I know nothing about latex so I cant' help with those.
>> But I filed bugs or updated the existing open bug:
>> - ccfits, "Overfull \hbox" latex error, see: https://bugs.debian.org/943423
>> - fltk1.3, "! Undefined control sequence." latex error, see: https://bugs.debian.org/943426
>> - frobby, LaTeX Error: File `listofitems.sty' not found, see: https://bugs.debian.org/921300
>> - lapack, easy to fix by just removing one line from d/rules, see: https://bugs.debian.org/943431
>> - librostlab, LaTeX Error: File `listofitems.sty' not found, see: https://bugs.debian.org/943420
>> - libstxxl, LaTeX Error: File `listofitems.sty' not found, see: https://bugs.debian.org/921298
>> - openms, "! Undefined control sequence." latex error, see: https://bugs.debian.org/943450
>> - ppl, "! Undefined control sequence." latex error, see: https://bugs.debian.org/943451
>> - qevercloud, LaTeX Error: File `listofitems.sty' not found, see: https://bugs.debian.org/921297
>> - sdformat, LaTeX Error: File `listofitems.sty' not found, see: https://bugs.debian.org/943421
> 
> Do the listofitems.sty-related errors go away if you build-depend on
> texlive-plain-generic?
> 
>  Best,
>  Gard

Thanks for the suggestion !
I had already hinted that as an option in the affected bugs.

I tried this fix with the last one (sdformat) and it now builds fine.
But I have not verified that the generated pdf looks fine, and there are quite a few latex warnings such as:

(/usr/share/texlive/texmf-dist/tex/latex/base/fixltx2e.sty
Package fixltx2e Warning: fixltx2e is not required with releases after 2015
(fixltx2e)                All fixes are now in the LaTeX kernel.
(fixltx2e)                See the latexrelease package for details.
...
LaTeX Warning: Command \underbar  has changed.
               Check if current package is valid.
...
Chapter 1.
(./deprecated.tex
LaTeX Warning: Reference `classsdf_1_1Color_a9cbaafc0da124ba6191fd19da5d126ed'
on page 1 undefined on input line 4.
...
(/usr/share/texlive/texmf-dist/tex/latex/psnfss/t1pcr.fd) [14] [15]
Package longtable Warning: Column widths have changed
(longtable)                in table 7.1 on input line 168.
...
Underfull \hbox (badness 10000) detected at line 188

In other cases I tried the same fix but got some funny latex errors (similar to those seen with fltk1.3 etc) which caused the build to fail.
BTW the maintainer of fltk1.3 has already fixed it to work with doxygen 1.8.16 with some magic here:
https://salsa.debian.org/ucko/fltk1.3/commit/6a4e109381e85cc5607ec142752ab27b7b9a59df

As with any software integration (here we are integrating doxygen, latex and package x) it can be solved only working together.
My job as doxygen maintainer is to make sure there is nothing systematically wrong from doxygen side.
I'd leave the choice how to best tackle these issues to the individual maintainers of the dependent packages.

If for any of the 8 remaining FTBFS the fix you suggested is not applicable or fails there are still 2 options:
- troubleshoot the core problem and fix it (help required from latex gurus), if necessary by patching / fixing doxygen to emit different latex code
- temporarily skip generation of refman.pdf (nobody reads those anyway ;-)

Paolo