I'm using the May 2008 Sandcastle CTP with the corresponding November patches from Sandcastle Styles, along with SHFB 18.104.22.168.
I'm documenting a single VB.NET 2005 assembly with fairly complete comments and the usual VS-generated documentation XML file. However, when I compile the help file, none of my internal cross-references work -- they all show up as the plaintext
instead of the linked version.
Doubtless, this is because of the warning pairs that show up in my log file, e.g.:
Warn: CachedResolveReferenceLinksComponent: Unknown reference link target 'Company.Product.TypeName1'.
Warn: CachedResolveReferenceLinksComponent: Invalid reference link target 'Company.Product.TypeName1'.
(The same thing happens if I don't use the resolver cache component, it just builds 5-15 seconds slower.)
I've looked at the various topics on this forum, and can't figure out how to apply any of the suggestions to my situation. Or perhaps I should say, I've tried everything I could think of (using the Additional Reference Links plugin, adding the assembly under
the References node, etc) and none of it has worked.
I really need the cross-references to work, and there's no good reason for them not to. Can someone please point me to some documentation that explains how to get cross-references to work?