[Issue 16462] mixin template ddoc doesn't appear in docs

[via Digitalmars-d-bugs]

https://issues.dlang.org/show_bug.cgi?id=16462

Vladimir Panteleev <dlang-bugzilla at thecybershadow.net> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEW                         |RESOLVED
                 CC|                            |dlang-bugzilla at thecybershad
                   |                            |ow.net
         Resolution|---                         |INVALID

--- Comment #3 from Vladimir Panteleev <dlang-bugzilla at thecybershadow.net> ---
It's the same as with any other composite declaration - you have to document
the top-level declaration so that the nested declarations are rendered. E.g.
here the documentation will be blank:

struct S
{
    /// foo
    int foo;
}

So, it's not specific to mixin templates.

Not sure if it's by design or not, but in any case, having a composite
declaration without documentation with members that do have documentation in it
might look weird at least in some DDoc themes.

Closing this seeing as there was some confusion as to the nature of the bug and
a workaround has been fonud; please reopen or file a new bug if you have a use
case for doing the above.

--