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.

On Sat, Dec 6, 2008 at 10:46 AM, Morusaka <morusaka@inwind.it> wrote:
> 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.

It might or might not make you feel better, but this has already been reported.  Twice.

http://d.puremagic.com/issues/show_bug.cgi?id=648 http://d.puremagic.com/issues/show_bug.cgi?id=2420

I wonder if the second should be marked as a dup of the first..

Jarrett Billingsley Wrote:

> It might or might not make you feel better, but this has already been reported.  Twice.
> 
> http://d.puremagic.com/issues/show_bug.cgi?id=648 http://d.puremagic.com/issues/show_bug.cgi?id=2420
> 
> I wonder if the second should be marked as a dup of the first..

Ooops, thank you Jarrett! Sorry I didn't check reported bugs. I hope this will be fixed with the next relases.

Luca.