It seems that doc generation is a separate task and phase from source code compilation. For example, mixin are not evaluated during doc generation and you can't generate comments with them:
[code] mixin ("/**\n * comment generated with a mixin\n */"); void foo() {} // no doc will be generated for function foo() [/code] why this behavior? Can't you think of a mixin that generates both code and doc for it? I think that will be nice, don't you? Thank you, Luca.