Wt

A "make doc" on Debian testing/jessie fails to build a significant portion of the documentation. Doxygen version 1.8.8 seems to ignore the Wt header files without suffixes. It looks like this is a change in Doxygen behavior starting with Release_1_8_8. I believe the relevant commit is: https://github.com/doxygen/doxygen/commit/0dd59398b3f62288897c8c3405977a27a94fbfee.

I'm not sure whether this Doxygen change was intended to affect backwards compatibility, but the incompatibility may affect packaged versions of Wt. For instance, I came across this buildd log on Debian that seems to be affected: https://buildd.debian.org/status/fetch.php?pkg=witty&arch=amd64&ver=3.3.3%2bdfsg-4.1&stamp=1416878754

In the above log, starting at around line 7802, there are "Preprocessing" lines for the .C files, but not for the associated headers. NOTE: The examples and other headers with .h suffixes have "Preprocessing" lines. There are numerous other errors logged, e.g. "sqlite3_step failed: NOT NULL constraint failed: memberdef.id_file", that may be cascading from this issue.

NOTE: This issue might be more appropriately filed as a feature request, as the Wt documentation builds fine with earlier versions of Doxygen. But, it seemed worth raising the priority due to the packaging concern.