Firstly, I want to thank Eric and all contributors for making it actually possible to make good use of Sandcastle without weeks of hair-pulling. :)
I have an SHFB project with multiple assemblies as inputs. One of the assemblies is in C++/CLI and defines a class as:
AttributeTargets::Assembly | AttributeTargets::Module | AttributeTargets::Struct | AttributeTargets::Class |
AttributeTargets::Enum | AttributeTargets::Constructor | AttributeTargets::Method | AttributeTargets::Property |
AttributeTargets::Field | AttributeTargets::Event | AttributeTargets::Interface | AttributeTargets::Delegate,
Inherited = false )]
public ref class SourceFileNameAttribute sealed : Attribute
The Fci namespace is part of my documentation but the Fci.ResourceCompilerSupport namespace has been excluded via the ApiFilter project property and this class has no XML comment.
I have the following in one of my conceptual topics:
The <codeEntityReference qualifyHint="false">T:Oakhurst.SourceFileBaseNameAttribute</codeEntityReference> attribute is
deprecated and may eventually be replaced by
I am under the impression that due to the qualifyHint="true" this should print as
Fci.ResourceCompilerSupport.SourceFileNameAttribute,but instead it is printing simply as
SourceFileNameAttribute. I realize that because this part of the API is excluded it will not be a hyperlink, but it should still show correctly. For instance,
System.Console correctly shows as such with the namespace when I use qualifyHint="true" even though it is not in my API either.
What might I be doing wrong here?
As a side note, is there any (fairly easy) way to cause this to be output in the normal C# syntax, which in the special case of attribute classes omits the "Attribute" suffix?
I realize that since this isn't even a link, it would be trivial to just hard-code the text as I want it, but I like to be correct, and eventually it might become a link and I don't want to have to search through manually to have to fix this sort of thing
when there are changes.
p.s., the SHFB version is 220.127.116.11.