How to install Doxygen on Ubuntu 20.04 LTS focal fossa

The commands in this tutorial to install Doxygen on Ubuntu 20.04 LTS can be used for Ubuntu 18.04/21.04, Linux Mint, Debian, ElementaryOS, MX Linux, POP!OS, and other similar distros.

Doxygen is a free software documentation tool. Using special comments in the source code, Doxygen creates documentation in HTML , LaTeX , CHM (help files under Windows), XML , RTF , PostScript , PDF and man pages . Doxygen analyzes both the comments and the source code itself in order to identify and document modules, classes, methods, and functions as well as various types of variables.

Since Doxygen analyzes the source code, it must be able to recognize the respective syntax. Among other things, C ++, C, Java, Objective-C, Python, IDL, Fortran, VHDL, PHP, C #, TCL, and partly D are officially supported.

Steps to install Doxygen GUI on Ubuntu 20.04 LTS

1. Refresh system repo cache

Before moving further, run once the system update command to refresh the system cache and also update the already installed packages.

sudo apt update

 

2. Install Doxygen on Ubuntu 20.04 LTS Linux

Well, we don’t need to add any third-party repository to install Doxygen, its packages are already available on the default Ubuntu package sources, we can get the following packages for this tool:

• doxygen
• doxygen-doc (documentation, optional)
• doxygen-gui ( universe – graphical user interface based on Qt, optional)
• graphviz (required to create diagrams; e.g. collaboration diagram, optional)

To install all of them you can run:

sudo apt-get install doxygen doxygen-doc doxygen-gui graphviz

Doxygen installation on Ubuntu 20.04

To check the installed version, we can use:

doxygen --version

And to see all the available options for the doxygen command, we can go for help:

doxygen --help

Now, to generate documentation of source code, use the following command-

doxygen -g TEST.conf

This will create a configuration file called TEST.conf. This is now to be edited with any text editor. As a rule, most of the settings can be retained. Some configuration parameters are listed in the Important Settings section.

In order to create the documentation, the following command is executed in the terminal:

doxygen TEST

After the program has run through, there is a new subfolder in the current folder, depending on the selected documentation format. For example, if HTML documentation was created, a directory named html was created. The index.htm file in it can now be viewed with any browser. In order to publish the documentation, all files in the html folder must of course be published.

 

3. Run Doxygen GUI- Graphical user interface

To use the graphical user interface, the doxygen-gui package must be installed. No Application launcher menu entry will be created by default after the installation. Hence, to use the application go to your terminal and simply run the command following command to start it.

doxywizard

Doxywizard summarizes all configuration parameters in a graphical user interface. Two approaches are offered for configuration. The “Wizard” tab only offers the basic setting options and enables beginners to configure Doxygen quickly and easily. If you need various fine adjustments and are familiar with Doxygen, select the “Expert” tab. All available parameters are displayed including a short explanatory text and grouped according to the topic.

After you have made all the required settings, you switch to the “Run” tab and start creating the documentation using the “Run doxygen” button. Depending on which format was selected for the documentation, there is a corresponding subfolder in the project directory (e.g. html ).

Doxygen GUI on Ubuntu

 

Uninstall or Remove Doxygen completely

sudo apt-get --purge remove doxygen doxygen-doc doxygen-gui graphviz

 

 

Leave a Reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.