C ++ XML注释生成MSDN样式CHM

时间:2009-07-01 03:07:21

标签: c++ documentation msdn chm

我有几个项目,一些使用托管代码,一些只使用非托管代码。所有都添加了XML注释并正确生成XML文档(生成的xml文件和xdc文件中间)。

当然有一些东西可以采取这些文件(xdcmake的输出)并生成MSDN样式的chm帮助! ? 根据我的理解,doxygen和sandcastle都忽略了这个显而易见的步骤并重新发明轮子来重新扫描你的代码。 (还有一个事实是,沙堡对非.NET项目显然毫无用处。)

尝试了doxygen(可怕的输出,但很快)和sandcastle(不错的MSDN风格输出,但是sloooooow)两者都乞求被更简单的东西超越。

如果有某种编辑器相关联,我们也可以编写任何API文档所需的“入门”和“信息”类页面,这也很好。

有谁知道任何解决方案?

3 个答案:

答案 0 :(得分:0)

老实说,Sandcastle是你最好的选择。我知道配置可能有点痛苦,但文档正是您正在寻找的样式。

答案 1 :(得分:0)

我知道人们仍在使用NDocConsole

的项目

但是我认为NDoc是一个死的项目,因为http://ndoc.sourceforge.net/自2005年以来没有更新

答案 2 :(得分:0)

您可能想尝试DoxyComment。以下是Doxygen的Helper tools & scripts

中的描述
  

用于Visual Studio 2005的插件调用   DoxyComment由Troels创建   公克。它旨在帮助您   插入上下文敏感评论   阻塞到C / C ++源文件中。   DoxyComment还附带一个xslt   允许您生成的模板   文档,如MSDN库。