mixin not evaluated during doc generation

[Morusaka]

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.