To help reduce the amount of logic that is in your crazy mess of a build script and to take advantage of improvements in doxygen, I'd like make 2 changes:
- instead of examples having a separate readme file, they will be more normal doxygen examples that start with a comment and an \example line with the files name (like headers do)
- module overview information will be stored in a file called overview.dox that you can edit directly, rather than have it be generated from data passed to SConscript. The data has to be escaped properly and is kind of a pain to deal with.
Both of these I will do for all the modules in the repository and I'll provide a script that can update the example files of a given model for modules that are elsewhere (since I have to interest in making such changes myself anyway :-).
I don't expect this to cause problems since I don't think people other than us generate docs.