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.
