问题
Is there a way to get documentation(like javadoc) in a visual-c++ project?
I'm using visual studio 2010.
thanks!
回答1:
You could use the XML-Documentation format, supported by VS2010, too. http://msdn.microsoft.com/en-us/library/ms177226%28VS.80%29.aspx
After commenting your code, you can use Sandcastle to create a MSDN-like documentation: http://sandcastle.codeplex.com/. (Here is a GUI representation for Sandcastle, which is a lot easier to use: https://github.com/EWSoftware/SHFB)
I use AtomineerUtils to create the XML-Documentation headers automatically. This tool will help you a lot. You can have free base version here: http://www.atomineerutils.com/products.php
回答2:
You can have a look at Doxygen.
回答3:
You could use my addin, Atomineer Pro Documentation to quickly generate documentation comments in Documentation-XML, Doxygen, Qt or JavaDoc format. Then use Sandcastle (DocXml) or Doxygen (DocXml, Doxygen, Qt, Javadoc) to convert this documentation into external documentation files.
I'd recommend uing DocXml format because all the above tools work with it, and Visual Studio recognises it (it syntax colours it, and it builds the docs into its intellisense database so it appears in tool-tip help as you type class/method names into your code).
回答4:
Also, take a look at CppTripleSlash - xml doc comments for c++. It is a free Visual Studio 2015, 2013, 2012, 2010 extension.
回答5:
One way to generate documentation is - you guessed it - javadoc. You simply have to comment the same way you usually do, and javadoc does a good job of converting them to HTML/LaTeX style.
Of course, that's not the only solution. I'll leave room for others.
回答6:
If you are using Visual Studio 2015 then there is a Doxygen generator written for the Macro explorer extension which uses JavaScript for it's macro language.
Project is on github here: https://github.com/cppocl/visual_studio_macros
回答7:
If you don't mind, some hand written documentation, then sphinx is the perfect tool.
http://www.sphinx-doc.org/en/stable/
and here is example:
http://ceres-solver.org/
sphinx-build -b singlehtml doc/ build/
来源：https://stackoverflow.com/questions/2840496/visual-studio-c-documentation-generator