#26 New Doxygen problems...

[Richard Rauch]

The documentation for OpenGLEAN is partially the result
of processing via Doxygen. Doxygen is now omitting lots
of documentation for unknown reasons.

Presumably this is caused by a Doxygen update; the
doxygen.log file now has many "Empty prototype" lines.
My guess is that it is no longer able to understand the
syntax quite as robustly as prior Doxygen releases.

So...temporarily, the HTML documentation is rather
broken. So is any LaTeX output. Thus the high priority
of this bug.

[Richard Rauch]

Logged In: YES
user_id=854844

The problem is caused by the obsolete \fn directive at the
top of functions.

This is problematic for me as dox.awk uses \fn to distinguish
function prototype items from internal items. I suspect that
I could hack dox.awk to pick up on the \brief directive
instead.

[Richard Rauch]

Logged In: YES
user_id=854844

A workaround is to define the command \fn to a NOP in
.../doc/doxygen.cfg.

I'll close this and think about fixing dox.awk to not require
\fn. I've marked the bug as "fixed" for lack of a better
category.