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