我到处都读过doxygen是为C#代码生成文档的方法.我有一个我想要首先记录的界面(婴儿步骤),它已经存在
XML注释(///).
由于有大量的帖子和信息(包括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 {...}