views:

767

answers:

2

In XML documentaiton comments for C#, is there a way to mark two or more functions to be overloads of each other, so that they reference each other automatically? Ideally, they'd also be grouped in the sandcastle-generated documentation somehow.

Purpose: Often, I want to link to this group of functions, e.g. in a list of utility functions, just mention one of the overloads, and make the others easily discoverable from there.

Currently I am adding links, but that's tedious.

+2  A: 

The relationship between multiple overloads are already identified and grouped by XMl documentation and Sandcastle.

Creating links to other members using the see or seealso tags.

Eg.

///See <see cref="M:AnotherMethod(System.String)">

I've found though that Sandcastle member resolution can be a bit flaky so I tend to use fully qualified names.

///See <see cref="M:MyCompany.Myapp.MyClass.AnotherMethod(System.String)">

Note the M: indicates a member is being referenced, you also use E: to point to an Event. T: is used for type but that is assumed if not present.

AnthonyWJones
+1  A: 

Grouping is done automatically by Sandcastle, right, but if you want to give overload group a common description, use <overloads> tag for this (in the same way as <summary>). It is not a standard XML documentation tag but AFAIR it is supported by Sandcastle Help File Builder.

vlad2135
that's pretty sweet. Is there any online documentation on the tags attributes?
smaglio81