doxygen for lazies

TL;DR: to get doxygen docs really fast you can run the doxify script as:

$ doxify path-to-project path-to-docs
# Done!
$ firefox path-to-docs/index.html

Let’s do the same for a small yet complex real-world C++ project: re2c.

The session looks like:

$ git clone https://github.com/skvadrik/re2c
$ doxify re2c/re2c/src re2c_docs
warning: Output language Russian not supported! Using English instead.
warning: failed to open layout file 'DoxygenLayout.xml' for reading!
warning: Included by graph for 'c99_stdint.h' not generated, too many nodes. Consider increasing DOT_GRAPH_MAX_NODES.
$ firefox re2c_docs/index.html

The docs generation process takes 9 seconds on my machive. I’ve uploaded result here. I won’t update that documentation thus it’s frost in time.

By default doxygen generates documentation only for explicitly documented files and functions thus we override that behaviour and force it to tell us everything it knows about the project. The following doxify line is responsible for it:

doxygen_set_value "EXTRACT_ALL" "YES"

Most of the rest is a nicety to get a code browser inline with documentation.

Let’s look at actually generated stuff. There is:

Under Classes there is Class Hierarchy dropdown. Some complex projects have huge class hierachies. One click and you know re2c is not one of them :)

Under Files we can find a lot of useful info as well. Picking main.cc as an example:

More random examples:

Have fun!

Posted on February 2, 2016
comments powered by Disqus