DDoc: comments on function templates are skipped for templates without doc comment

[dlangBugzillaToGithub]

Lionello Lunesu (@lionello) reported this on 2015-11-17T05:46:10Z

Transferred from https://issues.dlang.org/show_bug.cgi?id=15349

CC List

• John Hall

Description

template case3(fun...)
{
    /++ Blah
    Params:
        r = an value
    +/
    void case3(R)(R r){}
}

No doc is emitted for case3. Adding a DDoc comment on the template will cause the nested doc from being emitted.

[dlangBugzillaToGithub]

john.michael.hall commented on 2017-11-30T17:00:43Z

I have a related issue with the code below. When I compile this, I get the first one, but not the second one. Further, the top line foo(f...) does not show up, only T foo(f...)(T x).

/++
Some foo template
+/
template foo(f...)
{
    /++
    Foo here
    +/
    T foo(T x)
    {
        return f(x) + 1;
    }
    
    /++
    Alternate Foo here
    +/
    T foo(T x, T y)
    {
        return f(x, y) + 1;
    }
}