ddoc: Params for all elements?

[Carlos Santander]

Stewart Gordon escribió:
> Carlos Santander wrote:
>> I'm not sure if this should be flagged as a bug, but I find it odd 
>> that Params,
>> Returns, and maybe others are accepted for modules, aliases, classes, and
>> probably other elements. I mean, what does a module return? What are the
>> parameters of an alias? I think ddoc shouldn't allow those sections, 
>> but I'm not sure what the exact behavior should be.
> <snip>
> 
> If it's a template declared using the
> 
>     class C(T)
> 

Then it's a template and not a class. I never mentioned templates.

> notation, then it's the template parameter.  For an alias of a function 
> pointer or delegate type, it's the parameters of the function to be 
> expected.

Well, that's an special case, the exception to the rule ;)

> 
> Speaking of which, does any documentation system support a good way of 
> documenting the parameters/returns of function pointers/delegates that 
> are themselves parameter or return types?

I have no idea, but I can't imagine how that would work.

> 
> Stewart.
> 


-- 
Carlos Santander Bernal