[Issue 648] DDoc: unable to document mixin statement

[d-bugmail at puremagic.com]

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


Raphael Londeix <raphael.londeix at gmail.com> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |raphael.londeix at gmail.com


--- Comment #7 from Raphael Londeix <raphael.londeix at gmail.com> 2012-03-17 11:08:55 PDT ---
Hi,

I would say that document mixins themselves is not really useful (like Marco
Leise said, the targeted audience of the generated documentation). However,
since the compiler generates documentation (which is an awesome fact btw),
it could also generate doc for generated source code from mixins.

When the generated code goes on a public scope, having it documented is not
only useful, it is necessary. For example, I use mixin to generate some 
callbacks accordingly of a network protocol definition. Since the protocol
is known at compile time (and fully documented), these callbacks should be
documented as well.

Feature or bug, I don't know, but it's not working with dmd v2.058 :)

-- 
Configure issuemail: http://d.puremagic.com/issues/userprefs.cgi?tab=email
------- You are receiving this mail because: -------