为什么/文件(Doxygen)从msdn中删除?

时间:2016-09-21 09:57:23

标签: tfs2015 documentation-generation

我们在sd方法中使用TFS 2015内部部署。这样做我们想使用Visual Studio Build步骤在TFS中创建我们的构建。在执行此操作时,我们希望在构建流程中插入Documentation(Doxygen)步骤,但每次我们包含此步骤时,构建都会失败。

我试图得到一些答案,无论我们将其参数化为错误还是什么,所以我挖掘了互联网。经过一番研究后,我来到了这个网站: https://www.visualstudio.com/en-us/docs/build/define/build 在这个网站上我看不到文档(Doxygen)了,虽然我之前看过它。此页面的最新更新时间是2016年9月7日。

我们的TFS 2015保持最新,但仍然有Doxygen步骤。

我的问题:是不是以某种方式从TFS中排除了Doxygen,或者它会是什么?我们还有什么其他选择来使用TFS Build创建docuentation?

提前致谢, Collapo

2 个答案:

答案 0 :(得分:1)

微软从未对Doxygen提供过官方支持吗?

http://www.doxygen.nl/helpers.html

向下滚动到:

  

Visual Studio

     

如果您使用Visual Studio .NET,请查看Steve King的一套   加载项。 Greg Engelstad编写了一个perl脚本来解析Visual   Studio .NET解决方案文件(.sln)并为每个单独的运行doxygen   其中包含的项目。

     

Jason Williams为Visual Studio 2005编写了一个Addin& 2008年   它能够自动生成doxygen(或DocXml)样式注释   大多数代码元素(文件,命名空间,类,结构,枚举,函数,   等等)。它解析C,C ++,C#和Java代码以生成完全形成的   doxygen注释,如果代码元素是,则可以更新这些注释   改变了,并对描述进行自动换行以使其保持整洁。它使用了   一组用户可编辑的规则,用于提供自动描述   元素,参数和返回代码,最大限度地减少了工作量   在生成文档评论。

     

jgallardo还为Visual Studio编写了一个缓动的插件   浏览doxygen生成的文档。

     

创建了一个名为DoxyComment的Visual Studio 2005插件   Troels克。它旨在帮助您插入上下文   敏感注释阻塞到C / C ++源文件中。 DoxyComment也   附带一个xslt模板,可以生成类似的文档   MSDN库。

     

如果您使用的是Microsoft的Developer Studio 6.0,则会调用一个加载项   DoxBar可用于从内部运行doxygen   Developer Studio并搜索生成的HTML帮助文件。   注意:我没有足够的时间自己维护DoxBar,所以   我将DoxBar移动到sourceforge。 Olivier Sannier推出了一个号码   改进了DoxBar。如果你也想加入开发   团队,请在sourceforge注册为用户并将您的用户邮寄给我   名。

     

Bernhard Nowara写了一个个人资料编辑器,这是一个   适用于Windows的类似doxywizard的工具。他还创建了一个增强版本   DoxBar包括他的编辑器和Visual Studio的一些宏   轻松准备doxygen的源代码。这些改变了   已经被Olivier合并到更新版的doxygen中   Sannier。

     

FeinSoftware发布了Microsoft Visual的开发工具   Studio .NET(Visual C ++)称为CommentMaker,它创建   可自定义的函数头,开发人员可以调整到最多   具体文件要求。默认情况下它会生成doxygen   兼容的评论。

答案 1 :(得分:0)

文档(Doxygen)是第三方提供的扩展,它从未得到Microsoft的正式支持。

这是一个众所周知的问题,它无法与TFS2015内部部署服务器一起正常运行。有关详细信息,请参阅此链接:Documentation (Doxygen)

  

已知问题

     
      
  • 我们听说过扩展程序无法正常使用TFS 2015(OnPrem)服务器。
  •   
  • 文档中心无法在Internet Explorer / Microsoft Edge中加载。 (请立即使用谷歌浏览器)
  •