economicmodeling/harbored

Display documentation for specialized functions inside template

Closed this issue · 4 comments

It would be nice to be able to see the documentation for functions that are enclosed in a template.

An example would be std.algorithm.canFind: http://dlang.org/phobos/std_algorithm.html#.canFind

Do you mean that you want the documentation for functions and templates to be merged if they have the same name?

///bla
void thing()
{
    ;
}

///ditto
template thing()
{
    ///bla2
    void thing();
}

That's sufficiently confusing.

It turns out that this issue of documentation files being overwritten also applies to things like multiple templated structs with the same name, e.g.:

struct AStruct(T, int X) if (X < 100) { T t; }
struct AStruct(T, int X) if (X >= 100) { T t; }