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