Links in Visual Basic

I've successfully converted a lot of XML documentation in C# code that was originally developed for Visual Studio 2003 and NDoc to work with Visual Studio 2005 and Sandcastle with Sandcastle Help File Builder. Now I'm trying to do the same with some XML
documentation in Visual Basic code. The <see/> tags that I have converted to reference overloads by following the instructions in the
Linking to Overloads thread
http://www.codeplex.com/Sandcastle/Thread/View.aspx?ThreadId=22348&ANCHOR#Post74806 are working fine. But all the other <see> tags, which worked fine in NDoc, generate broken
links in Sandcastle. I've tried a few variations to no avail.

If there's a special trick to getting the references in <see/> tags in Visual Basic to work with Sandcastle, I would like to know what it is.

Check the XML file that the compiler creates for
<see/> elements that aren't working in Sandcastle. If the
cref appears valid, then maybe you could post some examples. If they don't appear valid, then the problem is with the syntax you're using in your comments. Again, posting a few examples may help.

The VB.NET compiler doesn't always generate fully qualified names in
cref attributes. It's got a bad habit of just outputting what you specify rather than a fully qualified member name with an appropriate prefix. The only known workaround is to fully qualify the name and include the prefix in your comments (T: for type,
M: for member, P: for property, etc). For example:

''' See the <see cref="M:MyClass.MyMember(System.Int32)"/> method.
''' See the <see cref="P:MyClass.MyProperty" /> property.

Eric's instructions worked fine with the addition of a couple of oddities. A few links still did not work after following Eric's instructions. I figured out the exceptions by comparing the
<see/> tags in the XML file with the headings for the corresponding referenced members in the same XML file. In each case where I had a broken link, the reference in the
<see/> tag did not exactly match the heading of the referenced member. From this investigation, I worked out two additional instructions.

1. If a referenced method contains a reference parameter (ByRef in VB), "@" must be appended to the parameter's type. For example :

''' See the <see cref="M:MyNamespace.MyClass.MyMethod(System.Object@)"/> method.

2. If a referenced method contains no parameters, closing parentheses must not be appended to the method name. For example :

I'm on VS2005 SP1. From what I've read in the various posts I've found it seems as though SP1 was the start of the problem. I'm not going to be moving to VS2008 anytime soon and don't have it available at the moment to investigate.

I was just (optimistically) hoping that maybe somebody had come up with a magical solution.

I see two Simons are now participating in the thread. I'm also on VS2005 SP1 with no plans to upgrade to VS2008 any time soon. I did not reply earlier because I've been out of the office for a few weeks.

Yes the odd VB behavior with crefs was invented in VS2005SP1. It was
somehow repaired in VS2008 but many crefs are still broken or target to unpredicable targets. I've read (not tested) that in VS2005SP1 you can workaround this by running vbc from command line.
I really dislike the way how VB team treats XML comments :-(.