Blog

3 minutes read
In Doxygen, you can show C++ style include syntax by using the #include command in your code comments. This will generate a list of included files at the top of your Doxygen documentation, providing a clear overview of the files and libraries that have been included in your project.
2 minutes read
To truly turn off latex output in Doxygen, you can set the GENERATE_LATEX option to NO in the Doxyfile. This will prevent Doxygen from generating any LaTeX files during the documentation generation process. Additionally, you can also set the LATEX_OUTPUT option to a blank string to ensure that no LaTeX output is generated at all. These settings will help you completely disable LaTeX output in Doxygen and focus only on generating other types of documentation formats.
3 minutes read
To link to the main page in Doxygen, you can use the syntax "<< mainpage >>" or just "<< main >>" within the Doxygen comments of your code. This will create a link to the main page of your documentation. Additionally, you can customize the name of the main page by setting the "main_page" configuration option in your Doxyfile. This will allow you to specify a different name for the main page link in your documentation.
4 minutes read
In Doxygen, the exclude_symbols configuration option can be used to exclude specific symbols from being documented in the generated output. This can be useful when there are certain functions, classes, or variables that are internal to the code base and not intended to be part of the public API documentation.To use exclude_symbols correctly in Doxygen, you need to specify the names of the symbols that you want to exclude in the Doxyfile configuration file.
3 minutes read
To generate a user manual using Doxygen, you first need to prepare your source code with appropriate Doxygen-style comments that document the functionality of your program or application. These comments should include details such as function descriptions, parameter information, and code examples.Once your source code is properly documented, you can run the Doxygen tool on your codebase to generate the user manual.
3 minutes read
To extract private class members with Doxygen, you can use the EXTRACT_PRIVATE configuration option in the Doxygen configuration file. This option allows you to include private class members in the generated documentation. By setting this option to YES, Doxygen will generate documentation for private members as well as public and protected members.
6 minutes read
When managing duplicate macro definitions with Doxygen, it is important to ensure consistency and clarity in your code documentation. One approach is to use the @name tag to group related macros together under the same header. This helps to organize and distinguish between different sets of macros, making it easier for users to navigate and understand the documentation.Additionally, you can use the @brief tag to provide a concise description of each macro, highlighting its purpose and usage.
4 minutes read
To create a list of switch case statements in Doxygen, you can use the @switch and @case commands.You can start by using the @switch command followed by the name of the switch statement. Then, for each case statement within the switch block, you can use the @case command followed by the case value.Make sure to use the correct syntax and formatting for each command to ensure that the list of switch case statements is properly documented in your code documentation.
4 minutes read
To add an HTML page in Doxygen, you first need to create the HTML page that you want to include in your documentation. You can use any text editor or HTML editor to create the page.Once you have created the HTML page, save it with a .html extension and place it in the same directory as your Doxyfile (configuration file for Doxygen).Next, open your Doxyfile in a text editor and find the INPUT tag. Add the path to the directory containing your HTML page to the INPUT tag.
2 minutes read
To selectively disable auto-links to examples in Doxygen, you can use the DISABLE_AUTO_LINKS configuration option in your Doxyfile. By setting this option to YES, Doxygen will not automatically create hyperlinks for examples in the documentation. This allows you to control which examples are linked by manually adding hyperlinks where needed. This can be useful if you have complex or specialized examples that may not need to be hyperlinked in the documentation.