DDoc and mixins

Gerald Stocker gobstocker at gmail.com
Sun May 6 19:19:38 PDT 2007


Ary Manzana wrote:
> I already asked for this:
> 
> news://news.digitalmars.com:119/erib78$g6c$1@digitalmars.com
> 
> with no answer. :-(
> 
> Maybe some think that if the code is generated by a mixin, than it is 
> trivial or easy to understand, because it follows a pattern (for 
> example, properties). However if a lot of classes are to be generated 
> this way, and they'll be part of some library, then you'd really like 
> them to have comments.
> 

Well, what I've been doing is trying to put as much information as is 
reasonable in the doc comments for the compile-time functions which 
generate the mixin strings. It's not too unworkable, but sometimes the 
information ends up in a different order than I would like.

--Gerald



More information about the Digitalmars-d mailing list