Bug#969142: frobby: FTBFS with doxygen 1.8.19

[Paolo Greppi]

Hi Douglas,

see below.

Il 30/08/20 13:57, Torrance, Douglas ha scritto:
> Control: tags -1 confirmed
> 
> On 8/28/20 3:43 AM, Paolo Greppi wrote:
>> while rebuilding the build dependencies of doxygen with the upcoming doxygen 1.8.19 (https://salsa.debian.org/debian/doxygen/-/wikis/ratt_doxygen_1.8.19-1_amd64-partial) this package FTBFS.
>>
>> This is the error:
>>
>> sh: 1: dot: not found
>> error: Problems running dot: exit code=127, command='dot', arguments='"/<<PKGBUILDDIR>>/bin/develDoc/html/graph_legend.dot" -Tpng -o "/<<PKGBUILDDIR>>/bin/develDoc/html/graph_legend.png"'
>> Doxygen version used: 1.8.19 (552186a667287506d0359bb1ae14d11ad531bb25*)
>>
>> This should be pretty easy to fix: just add graphviz to the build deps.
> 
> Thanks for the report!
> 
> After adding graphviz to Build-Depends, I get a build error a bit 
> further down:
> 
>> cd bin/develDoc/latexPdf; for f in `ls *.eps`; do epstopdf $f; done # Cygwin fix
>> /bin/sh: 1: cd: can't cd to bin/develDoc/latexPdf
>> ls: cannot access '*.eps': No such file or directory
>> cd bin/develDoc/latexPdf/; make refman.pdf; mv refman.pdf ../develDoc.pdf
>> /bin/sh: 1: cd: can't cd to bin/develDoc/latexPdf/
>> make[3]: Entering directory '/root/frobby'
>> make[3]: *** No rule to make target 'refman.pdf'.  Stop.
>> make[3]: Leaving directory '/root/frobby'
>> mv: cannot stat 'refman.pdf': No such file or directory
>> make[2]: *** [Makefile:279: develDocPdf] Error 1
>> make[2]: Leaving directory '/root/frobby'
>> dh_auto_build: error: make -j1 "INSTALL=install --strip-program=true" all library doc develDoc MODE=shared library=libfrobby.so.0.0.0 returned exit code 2
>> make[1]: *** [debian/rules:13: override_dh_auto_build] Error 25
>> make[1]: Leaving directory '/root/frobby'
>> make: *** [debian/rules:10: binary] Error 2
>> dpkg-buildpackage: error: debian/rules binary subprocess returned exit status 2
>> debuild: fatal error at line 1182:
>> dpkg-buildpackage -us -uc -ui failed
> 
> I'll investigate further and try and figure out what's going on.
> 
> Doug

Thanks for the info, this is very interesting.

It looks like doxygen fails to create the bin/develDoc/latexPdf/ dir in the preceding line of the Makefile:
https://salsa.debian.org/science-team/frobby/-/blob/master/Makefile#L280

I have manually tried this command from the develDocHtml target:
cat doc/doxygen.conf doc/doxHtml|doxygen -

and it apparently succeeds, but produces empty documentation in bin/develDoc/html

These commands work:

  rm -rf Doxyfile
  cat doc/doxygen.conf doc/doxHtml > Doxyfile
  doxygen

while "doxygen -" is broken due to a known doxygen 1.8.19 bug, see:
https://github.com/doxygen/doxygen/issues/7951#issuecomment-671370005

This is serious so I'll now release 1.8.19 to unstable and simultaneously file a RC bug in the BTS to block it.

According to upstream, this has been fixed in the doxygen version 1.8.20 which they already released.
I plan to package it ASAP so I suggest you wait for that and not patch your Makefile.

Paolo