首先,我见过从 C# XML 注释生成文档 https://stackoverflow.com/questions/48381/generating-documentation-from-c-xml-comments和许多其他人喜欢它,但建议的工具都不能满足我的需要。
我需要一个免费工具,可以从我的源代码生成文档(最好是 html 格式),而无需使用 Visual Studio 创建的 xml 文档。该项目在打开错误时会发出警告,并且检查生成该 xml 文件的选项会产生数百个错误。实际上,这排除了 90% 的 C# 文档生成器,包括 Sandcastle、NDoc3、Live Documenter、docu 和 ImmDoc。
Doxygen 几乎可以工作,但我似乎无法让它为重载的泛型类生成文档,例如:
public class MyClass<Foo>
public class MyClass<Foo, Bar> : MyClass<Foo>