Some people suggested Doxygen, some ccdoc, which should be more similar to javadoc but is less supported. What's your opinion?
I use Doxygen as it has class diagrams, function call diagrams, a search engine et al. Overall it looks a lot more advanced than ccdoc (I haven't used ccdoc).
However, Doxygen supports Javadoc style tags and as ccdoc is based on Javadoc I assume it does as well, why not give them both a try? See which you like better?
I use doxygen since you can modify a lot of parameters to personalize the output. In addition you can generate the doc in different formats (that can be useful).
I don't know about ccdoc, but Doxygen supports Javadoc style comments.
I use Doxygen for several reasons:
- Call graphs
- Collaboration Graphs
- Inheritance Graphs
- Dependency Graphs
Before anything is committed, all changes must be documented and our regular builds involve generating documentation. These very handy features of Doxygen increase the bus factor on any project.