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