• d-bugmail puremagic.com Dec 04 2006
• d-bugmail puremagic.com May 06 2007

d-bugmail puremagic.com writes:

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

           Summary: DDoc: unable to document mixin statement
           Product: D
           Version: 0.176
          Platform: PC
        OS/Version: Windows
            Status: NEW
          Severity: normal
          Priority: P2
         Component: DMD
        AssignedTo: bugzilla digitalmars.com
        ReportedBy: tomas famolsen.dk


/// 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...


-- 

d-bugmail puremagic.com writes:

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


gobstocker gmail.com changed:

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




------- Comment #1 from gobstocker 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.


--