www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.learn - mixin not evaluated during doc generation

reply Morusaka <morusaka inwind.it> writes:
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.
Dec 06 2008
parent reply "Jarrett Billingsley" <jarrett.billingsley gmail.com> writes:
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..
Dec 06 2008
parent Morusaka <morusaka inwind.it> writes:
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.
Dec 06 2008