Javadocs documentation for C++

Question

Is it possible to use the javadocs documentation system for other languages. Since javadocs produces such a nice output it would be great if you could use it in other languages. If this isn't possible, what other documentation generators are used for the C++ language, preferably opensource.

Answer 1

There's Doxygen

Answer 2

You can't use javadoc specifically, but there are a couple of tools that do what you want. The one most people tend to use is Doxygen. Here are some links for Doxygen and Doc++:

Doxygen
Doc++

Answer 3

There are several tools that works like JavaDoc for C++ The most popular tool is probably Doxygen. It can handle JavaDoc-like comments, and also several languages (e.g., C++, C, Java, Objective-C, Python, PHP, C#). It has pretty good support for tweaking the style of the HTML output using CSS (see the users list for example documentations).

Two important issues when choosing the documentation system is to make sure that it allows you to

• Document the entities that you are interested in. Do you want to document the system following the code structure or according to some other module division.
• Getting the output formatted as you want. It is preferable when the documentation fits in with your general project style.

Our experience with doxygen is that it is pretty easy to set up and use, and the resulting output is fairly easy to tweak. Unfortunately, doxygen is not perfect, so in some cases it is necessary to work around quirks or bugs where the doxygen parser breaks down. Be sure to inspect all of your generated documentation carefully.