C#

/// <summary>
/// Great big long multiline explanation of foo()
/// </summary>
public void foo() {...}

/// <summary autodoc=foo()/>
/// <parm name="x">Put a number here</param>
public void foo(int x) {...}


/// <summary autodoc=foo()/>
/// <parm name="x">Put a number here</param>
/// <parm name="y">Put a second number here</param>
public void foo(int x, int y) {...}
...

/// <summary autodoc=foo()>
/// but, unlike foo(), this method does not accept negative values.
/// </summary/>
/// <parm name="x">Put a number here</param>
/// <parm name="y">Put a second number here</param>
public void goo(int x, int y) {...}
...

cpotting wrote:

I must say that I am surprised that this seems to have been overlooked when the XML documentation ability was being created. It seems (to me, at any rate) to be an obvious feature to be included - much more so than the <seealso> or <include> tags.