Search for a command to run...
I have been writing code since the mid 1990s. I started out my professional career building applications and games for mobile phones (J2ME, Palm, Symbian, etc) then some Android, iOS and then moved to building server applications using Spring framework, and frontend using JQuery. Now working on Spring Boot, Docker, Flutter etc.
No comments yet. Be the first to comment.
For those who work extensively with Asciidoc files, having a robust and feature-rich editing tool is essential. We have already see the power of Asciidoc and Asciidoctor in our previous articles as a writer's tool and a presentation tool. In this art...
The previous article our focus has been on delving into foundational elements of LangChain4j such as ChatLanguageModel, ChatMessage, ChatMemory, and others. Working with components at this level offers great flexibility and complete control, but it c...
In the preceding article, we were introduced to AI/ML concepts and explored the process of running a local Large Language Model (LLM) - Ollama. We further delved into interacting with it via Java using JBang and Langchain4j. Now, let's explore into ...
The realm of AI/ML, especially Generative AI, has garnered significant attention worldwide following the emergence of ChatGPT. Consequently, there has been a surge of interest in developing various models and tools within this domain. In this article...
In today's fast-paced tech world, giving effective presentations is crucial for conveying complex ideas and engaging audiences. While Markdown has emerged as a popular lightweight markup language for creating rich text documents, its use in creating ...
Going through the code and understanding it is a daunting task, esp. if the code is written by someone else. It would be a nightmare if the code is not documented.
The plight is usually for the developers who are tasked to maintain a code that is written by someone else.
Sometimes the situation is developers don't know where to begin, and understanding it is even more a herculean task. It would be great if they had somewhere to start and understand the code that they are going to breath through.
Enter Doxygen!
Doxygen has been there for almost a quarter of a century, written by Dimitri van Heesch. There are other tools documentation generators too. Javadoc for example is very popular because of the way the code documentation is organized.
The beauty of doxygen is it has features to help understand code better even in if the code is not documented properly. It supports these source languages out of the box - C/C++, Java, Python, VHDL, PHP IDL, C#, Fortran, Objective-C 2.0, and to some extent D. It also supports a variety of output formats.
Doxygen has a robust and big set of features that this article's space is too small to contain, so we will look at it from the perspective of understanding code.
Doxygen has a great feature of generating something called call-graphs. Call graphs are control flow graphs that shows what all functions/methods a particular function/method calls.
An example of a call-graph would be like the diagram below
So in order to understand the code first, call-graphs are a great way to understand the code flow, even if the code is poorly or even not documented.
Doxygen provides both the command-line version and a wizard that guides us through the documentation generation process
We can use either to generate the documentation, however for newbies the wizard will help generating the configuration file necessary to generate the documentation
To generate the call graphs, doxygen requires the dot tool to be available in the path. dot tool is a part of the graphviz package that helps generate the call-graphs.
The doxygen documentation page has a very clear steps on how to use the wizard to generate the documentation. In the Diagrams tab, we will have to select the Call graphs option to generate the call graphs. Of course, it take a bit of time to generate the call-graphs.
Once the documentation is generated, we can start navigating from the whatever is the main class methods and click on the call-graph functions to navigate through the entire code.
Go ahead try doxygen and see!
In the next part of this article we'll see about eclox, the eclipse plugin for doxygen.
Header Image Credits: Pixabay
