Back to Blog
Integrate doxygen in visual studio6/8/2023 I would recommend starting with DocXml comments and Doxygen to generate the external help, as that's the cheapest and easiest way to get started, and retains all the best features of VIsual Studio (intellisense etc). On the plus side, Doxygen does parse the DocXml format, so you can get the best of both worlds by using the DocXml format with Doxygen to generate the external help.Ĭommercial products like DocumentX, which allow you to edit the documentation in a WYSIWYG window. This is easier to use and more flexible, but not supported by Visual Studio, so you lose the intellisense and syntax colouring advantages. The advantage of this is that Visual Studio recognises the documentation (it syntax-colours the comments) and the documentation is instantly picked up by the Intellisense system (so if you hover your mouse pointer over a method you are calling, the tooltip will display the summary and parameter information that you entered in the Doc Comment) Use DocXml documentation comments, and then Sandcastle or a similar tool to build MSDN-style documentation. There are several options for documentation: NET developers (with Sandcastle and Sandcastle Help FileBuilder). You can generate documentation in the standard Doxygen layout your organization is familiar with (becauses Doxygen supports XML comments) plus you have the option to generate documentation in a format known to. To sum up: I would recommend to use XML comments over special Doxygen comments for C# code. If you want to use Doxygen, this is no problem as it supports parsing XML comments. You can configure Visual Studio to generate an XML file from all the comments, which would then be fed into a documentation generator like Sandcastle. To document a method, just type three slashes ( ///) in front of the method body, and Visual Studio will insert an empty comment template for you to fill, like so: /// In my opinion this is the best way to go for C# code because support for this is already integrated in Visual Studio (comment tag auto completion, warning about missing or incorrectly spelled parameters. ![]() The default way of documenting C# code in Visual Studio is by XML documentation comments.
0 Comments
Read More
Leave a Reply. |