Recent Doxygen vs our docs

[Paolo Carlini]

Hi Phil, hi everyone.

as you already warned some time ago, recent doxygen distributions are
not able to create our docs.

Actually, here the situation seems even more serious, since no doxygen
package more recent than 1.3.2 seems to work.

Moreover, trying to build now doxygen-1.3.2 (gcc-3.3.3 + bison1.875)
leads to:

bison -l -p cppExpYY constexp.y -o ce_parse.cpp
g++ -c -pipe -Wall -W -fno-exceptions -O2 -I../qtools -I../libpng -o 
../objects/ce_parse.o ce_parse.cpp
ce_parse.cpp: In function `int cppExpYYparse()':
ce_parse.cpp:1548: error: parse error before `goto'
ce_parse.cpp:1539: warning: label `yyerrlab1' defined but not used
gmake[2]: *** [../objects/ce_parse.o] Error 1

Luckily, provided the junk yyerrlab1: is removed by hand everything goes
well and the resulting doxygen creates our docs without a glitch.

What should we do? Shall we add something to the 3.4 Release notes?

Thanks,
Paolo.