[Doxygen-develop] Feature request: Return EXIT_FAILURE when option WARNINGS_ARE_ERRORS = YES

[Troy W. <dr...@gm...>]

It would be useful to have Doxygen return from main() with a status
code. This would allow scripts and makefiles to raise an error if
documentation is incomplete. Similar to the gcc argument -Werror.
Currently main() just returns 0.

I've had a brief look at the Doxygen source, and have hacked in a
smelly approximation using a global 'return_value' variable that is
set to EXIT_SUCCESS by default, but changed by the functions in
message.cpp when a warning is printed. i.e. When the warning message
functions are called, the global return_value variable is set to
EXIT_FAILURE, and main() returns this variable when finished. It
works, but not particularly well! A proper implementation would
ideally stop processing at the first warning/error and return
immediately.