Update on Doxygen adventures

[Ricardo Lafuente]

Hi all, here's a rundown of our fights with Doxygen so far.

So, our ideal situation would be to use Doxygen for the whole site -- 
Libor has been using it effectively for the non-technical part of the 
docs (and a blog!) which was a revelation to us. So we set out to see 
how Doxygen can be twisted to use different layouts and allow deeper 
customization.

However, after a lot of experimentation and doc reading, we found that 
Doxygen only supports adding custom headers and footers -- the HTML 
templates themselves are not exposed to the user and cannot be overridden.

So our way out seems to be to make a custom Doxygen build with our 
templates. It sounds overkill, but we couldn't find a way that's less 
complex. There are a few libraries that can extract JS comments, but the 
Doxygen syntax is not rendered and we'd have to write a parser for those.

Maybe you know of a saner approach? We can discuss this tomorrow in our 
call.