使用doxygen为带有XML注释的现有C#代码创建文档

由于有大量的帖子和信息(包括doxygen.org)说这些评论已经得到支持,我很惊讶当我运行doxywizard时,我收到的错误如“警告：复合公司::产品:: MyInterface是没有记录“.

这让我相信我在某种程度上误解了XML文档(希望不是,根据MSDN我说的是正确的事情),或者我错误配置了doxywizard.

我首先通过向导选项卡运行doxywizard,并指定我想支持C#/ Java.当我运行它时,我的HTML页面是空白的,大概是因为前面提到的警告.然后我尝试通过专家选项卡指定单个文件并再次运行 – 相同的行为.

任何人都可以告诉我什么开关或设置我缺少得到doxygen来生成HTML？

以下是我的界面中记录的属性/方法的示例：

/// <summary>
/// Retrieve the version of the device
/// </summary>
String Version { get; }

/// <summary>
/// Does something cool or really cool
/// </summary>
/// <param name="thing">0 = something cool,1 = something really cool</param>
void DoSomething( Int32 thing);

我在界面上面有一条评论,如下所示：

/// <summary>
/// MyInterface
/// </summary>
public interface MyInterface {...}