Improvements added by Dirk Reiners:
I added two (at least for me ;)) important features of doxygen:
variable substituion and hierarchical doxygen files.
Variable substituion allows doxygen to reference variables from the scons environment using $(VARNAME).
This is very useful for things like version numbers or for only having certain parts (as defined by scons)
included in the documentation without having to mess with doxygen files.
Hierarchical doxygen files just interpret the @INCLUDE key as an include.
I also had trouble with files that started with a key, I fixed that.
Note that I'm a python newbie, so there are probably more elegant ways to do some of the things I did.
Feel free to change them.
Hope it helps.
__Remark__: as of 2025, this is the oldest code version that can be documented.
The content is taken from an Achive.org snapshot from June 21, 2006
https://web.archive.org/web/20060621095023/http://www.scons.org/wiki/DoxygenBuilder
Based on the comments added 2010-03-07 by Russel Winder,
this code can be attributed to Matthew Nicolson
