admin管理员组

文章数量:1123707

In recent times I annotated my entire large C# project with XML documentation, and I also made heavy use of the inheritdoc notation (for example when we are overriding a base class method). Imagine my surprise and horror when I looked at the resulting XML and found that it actually said "inheritdoc". That is: the XML didn't inherit the text (the whole point of doing this) but just put an inherit element in there.

As a small-time nerd who wants to do my own XML-to-HTML conversion: how can I make it actually copy the text (as inheritdoc suggests)? I can't understand the meaning of inheritdoc in an XML file, because (given the C# source code, and complicated rules around types and parsing) you might be able to determine what inherits from what, but given the XML alone, you have no clue.

I just want an XML file with all my comments, and where I wrote 'inherit' in the source, I want that text copied in the docs output. Wow!

本文标签: C XML documentation dealing with the entiretyStack Overflow