Ddoc doesn't support documentation for mixined code?
Alex Moroz
hypothermia.frost at gmail.com
Fri Dec 10 14:04:04 PST 2010
Hi,
As of present Ddoc doesn't seem to process documenatation for code that is
inserted with mixins.
For example:
/**
*Declares a protected field of type T, with default setter and getter for
it.
*/
template Property(T,string name,string setterExtra="")
{
enum string Property="void "~name~"("~(T).stringof~"
_"~name~"){this._"~name~"=_"~name~";"~setterExtra~"}///ditto\n nothrow
"~(T).stringof~" "~name~"(){return this._"~name~";} protected
"~(T).stringof~" _"~name~";";
}
/**
*item.
*/
class Item: {
/**
*No documentation generated!
*/
mixin(Property!(Image,"image"));
}
I think its important keeping the documentation together, and I probably
will have to switch to hand written methods because of this.
So will it will ever be possible that ddoc will actually generate the
documentation? Or are there any other ways to achieve this?
Thanks
More information about the Digitalmars-d-learn
mailing list