[Issue 648] DDoc: unable to document mixin statement

[d-bugmail at puremagic.com]

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


gobstocker at gmail.com changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
         OS/Version|Windows                     |All
            Version|0.176                       |1.014




------- Comment #1 from gobstocker at gmail.com  2007-05-06 23:12 -------
(In reply to comment #0)
> /// this is a class
> class A
> {
> /// This mixin will bla bla bla
> mixin MyMixin!();
> }
> 
> this will only generate docs for the class. not the mixin.
> Some will probably consider this a feature request, but I'd call it a bug...
> 

The same occurs with mixin declarations (DMD 1.014 on linux):

/// Documentation for foo.
mixin("int foo;");

mixin("int foo; /// Documentation for foo.");

And docs are not generated for foo or bar.

Gregor Richards pointed out in 
news://news.digitalmars.com:119/f1m3u7$26g8$1@digitalmars.com
that mixins are parsed much later than ddoc comments.

But I would also consider this a bug.


--