Doxygen Filter for System Verilog 1.5.3 Released

When the OVM 2.0 release came out I ran it through my doxygen filter and found a couple of new issues.  Those issues have been corrected in the 1.5.3 release posted here:

http://www.intelligentdv.com/downloads/index.html#doxygentools

The most significant issue found and corrected in 1.5.3 was the filter was processing SV keywords that were inside of a double quoted text string (which lead to some pretty goofy results when a string contained a keyword; esp keywords like begin or end). The filter now skips quoted text in the same way that it skips commented text. And the more heuristic debug I find myself doing the more I wish I’d used a proper grammar. I have an unnatural fear of Yacc (and other large mammals!)

Also, in the template converter script I’ve added support for escaped linefeeds in a .delta file.

Details about how to install and use filter, along with examples, can be found in the original filter release post.

“begin filtering!”

2 Responses to “Doxygen Filter for System Verilog 1.5.3 Released”

  1. Rajesh Kovvuri Says:

    Thanks!!

    I tried this tool by making some changes to the Makefile. I wanted documentation for an OVC i am building. I can see the html now. But no graphical info on the class relationships. All the *.png files are 0-bytes. Do i need some different tool to generate these graphs??

  2. Sean Says:

    @Rajesh

    To get the amazing looking graphs you’ll need to install the graphviz tools on the machine where you’re running doxygen — specifically dot.
    More info here:
    http://www.doxygen.org/diagrams.html
    and here:
    http://www.graphviz.org/

    Alternatively - you can set the HAVE_DOT variable to NO in your doxyfile. Doxygen will generate some so-so looking graphs natively.

    -Sean

Leave a Reply