www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.bugs - [Issue 648] New: DDoc: unable to document mixin statement

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


-- 
Dec 04 2006
parent 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. --
May 06 2007