为什么/从 msdn 中删除了文档 (Doxygen)?
Why / is Documentation (Doxygen) removed from msdn?
我们在 sd 方法中使用本地 TFS 2015。为此,我们希望使用 Visual Studio 构建步骤在 TFS 中创建我们的构建。在执行此操作时,我们想将文档 (Doxygen) 步骤插入到构建流程中,但每次我们包含此步骤时,构建都会失败。
我试图得到一些答案,无论是我们将其参数化有误还是什么,所以我上网查了一下。经过一些研究,我来到了这个网站:
https://www.visualstudio.com/en-us/docs/build/define/build
在这个网站上我再也看不到文档(Doxygen),尽管我之前看到过它。此页面的最新更新时间为 2016 年 9 月 7 日。
我们的 TFS 2015 保持最新,但仍有 Doxygen 步骤。
我的问题:Doxygen 是否以某种方式被排除在 TFS 之外,还是会被排除?我们还有哪些其他替代方法可以使用 TFS Build 创建文档?
提前致谢,
科拉波
微软从来没有官方支持过Doxygen?
http://www.doxygen.nl/helpers.html
向下滚动到:
Visual studio
If you use Visual Studio .NET have a look at Steve King's set of
addins. Greg Engelstad has written a perl script to parse a Visual
Studio .NET solution file (.sln) and run doxygen for each separate
project contained therein.
Jason Williams has written an Addin for Visual Studio 2005 & 2008
which is able to auto-generate doxygen (or DocXml) style comments from
most code elements (file, namespace, class, struct, enum, function,
etc). It parses C, C++, C# and Java code to produce fully formed
doxygen comments, and can update those comments if the code element is
changed, and word-wrap the descriptions to keep them tidy. It uses a
set of user-editable rules to provide automatic descriptions of
elements, parameters and return codes, minimizing the effort involved
in generating doc comments.
jgallardo has also written a Addin for Visual Studio that eases
browsing the documentation generated by doxygen.
An addin for Visual Studio 2005 called DoxyComment was created by
Troels Gram. It is designed to assist you in inserting context
sensitive comment blocks into C/C++ source files. DoxyComment also
comes with an xslt template that lets you generate documentation like
the MSDN library.
If you are using Microsoft's Developer Studio 6.0, an add-in called
DoxBar is available that can be used to run doxygen from within
Developer Studio and to search through the generated HTML help files.
Note: I do not have enough time to maintain DoxBar myself anymore, so
I moved DoxBar to sourceforge. Olivier Sannier has introduced a number
of improvements to DoxBar. If you too want to join the development
team, please register as a user at sourceforge and mail me your user
name.
Bernhard Nowara has written a profile editor, which is a
doxywizard-like tool for Windows. He also created an enhanced version
of DoxBar that includes his editor and some macros for Visual Studio
to ease the preparation of the source code for doxygen. These changed
have been merged into more recent version of doxygen by Olivier
Sannier.
FeinSoftware has released a development tool for Microsoft Visual
Studio .NET (Visual C++) called CommentMaker, which creates
customizable function header that developers can adjust to most
specific documentation requirements. By default it generates doxygen
compatible comments.
Documentation (Doxygen) 是第 3 方提供的扩展,Microsoft 从未正式支持它。
并且它不能与 TFS2015 本地服务器一起正常工作是一个已知问题。详情参考这个link:Documentation (Doxygen).
Known Issues
- We have heard about extension not working properly with TFS 2015 (OnPrem) server.
- The Documentation hub doesn't loads in Internet Explorer/Microsoft Edge. (Please use Google Chrome for now)
我们在 sd 方法中使用本地 TFS 2015。为此,我们希望使用 Visual Studio 构建步骤在 TFS 中创建我们的构建。在执行此操作时,我们想将文档 (Doxygen) 步骤插入到构建流程中,但每次我们包含此步骤时,构建都会失败。
我试图得到一些答案,无论是我们将其参数化有误还是什么,所以我上网查了一下。经过一些研究,我来到了这个网站: https://www.visualstudio.com/en-us/docs/build/define/build 在这个网站上我再也看不到文档(Doxygen),尽管我之前看到过它。此页面的最新更新时间为 2016 年 9 月 7 日。
我们的 TFS 2015 保持最新,但仍有 Doxygen 步骤。
我的问题:Doxygen 是否以某种方式被排除在 TFS 之外,还是会被排除?我们还有哪些其他替代方法可以使用 TFS Build 创建文档?
提前致谢, 科拉波
微软从来没有官方支持过Doxygen?
http://www.doxygen.nl/helpers.html
向下滚动到:
Visual studio
If you use Visual Studio .NET have a look at Steve King's set of addins. Greg Engelstad has written a perl script to parse a Visual Studio .NET solution file (.sln) and run doxygen for each separate project contained therein.
Jason Williams has written an Addin for Visual Studio 2005 & 2008 which is able to auto-generate doxygen (or DocXml) style comments from most code elements (file, namespace, class, struct, enum, function, etc). It parses C, C++, C# and Java code to produce fully formed doxygen comments, and can update those comments if the code element is changed, and word-wrap the descriptions to keep them tidy. It uses a set of user-editable rules to provide automatic descriptions of elements, parameters and return codes, minimizing the effort involved in generating doc comments.
jgallardo has also written a Addin for Visual Studio that eases browsing the documentation generated by doxygen.
An addin for Visual Studio 2005 called DoxyComment was created by Troels Gram. It is designed to assist you in inserting context sensitive comment blocks into C/C++ source files. DoxyComment also comes with an xslt template that lets you generate documentation like the MSDN library.
If you are using Microsoft's Developer Studio 6.0, an add-in called DoxBar is available that can be used to run doxygen from within Developer Studio and to search through the generated HTML help files. Note: I do not have enough time to maintain DoxBar myself anymore, so I moved DoxBar to sourceforge. Olivier Sannier has introduced a number of improvements to DoxBar. If you too want to join the development team, please register as a user at sourceforge and mail me your user name.
Bernhard Nowara has written a profile editor, which is a doxywizard-like tool for Windows. He also created an enhanced version of DoxBar that includes his editor and some macros for Visual Studio to ease the preparation of the source code for doxygen. These changed have been merged into more recent version of doxygen by Olivier Sannier.
FeinSoftware has released a development tool for Microsoft Visual Studio .NET (Visual C++) called CommentMaker, which creates customizable function header that developers can adjust to most specific documentation requirements. By default it generates doxygen compatible comments.
Documentation (Doxygen) 是第 3 方提供的扩展,Microsoft 从未正式支持它。
并且它不能与 TFS2015 本地服务器一起正常工作是一个已知问题。详情参考这个link:Documentation (Doxygen).
Known Issues
- We have heard about extension not working properly with TFS 2015 (OnPrem) server.
- The Documentation hub doesn't loads in Internet Explorer/Microsoft Edge. (Please use Google Chrome for now)