Questions tagged [doxygen]
Doxygen is a multilanguage documentation generation application for C++, C, Java, Objective-C, Python, IDL, Fortran, VHDL, PHP and C# that supports a wide variety of output formats including RTF, HTML, XML and PDF.
3,084
questions
0
votes
0
answers
29
views
Read structured file with doxygen
doxygen noob here, but I can't find answers anywhere.
My goal is to parse this file and extract (1) the parameter name found under Classes -> Attrs (in this case calParameterName_1), and (2) the ...
1
vote
0
answers
31
views
gtest documentation using Doxygen on custom annotations
I am looking for the auto generation of my unit tests documentation. Specifically, I would like to use doxygen on my c++ project that scans it and looks for unit tests implemented in gtest (TEST/...
0
votes
0
answers
10
views
How to link a word of one markdown file to another markdown file in doxygen?
I have a main markdown file in one folder and other markdown files in subfolders and i wanted to link the word of main markdown file with the markdown files of subfolders. How Doxygen automatically ...
0
votes
1
answer
21
views
If I have @fn then everything is being ignored
Example:
/**
* @fn IOChunk_t ioAllocateLargestChunk*(void)
* @brief Allocates the largest available chunk.
*
* @return pointer to allocated @ref IOChunk_t or @ref NULL if allocation failed
*/
...
0
votes
0
answers
11
views
Doxygen converts code span in heading to literal text (i.e. adding HTML escape to tag <tt>)
For example, if I write Doxygen document as:
## Heading line with `code span`
The resulting HTML would be:
<h2>Heading line with <tt>code span</tt></h2>
It ...
0
votes
0
answers
10
views
vscode - interpret HTML tags in Doxygen comments in such a way that, when displaying the documentation for the method, it properly renders the HTML
I have the following Doxygen-styled comment in an example C/C++ function in vscode.
How to make the tool to interpret HTML tags within the Doxygen-style comment in such a way that, when displaying the ...
1
vote
0
answers
9
views
doxygen and C# Xml comments conflict on specifying symbols
I have a C# project (VS2019) with XML-style documentation comments.
Documentation is generated with doxygen.
Numerous comments must include the trademark symbol. I'd like this to show up correctly in ...
0
votes
0
answers
32
views
How to update the Doxygen plugin in Qt Creator 10.0.0 for successful use
How to use the Doxygen plugin compatible with Qt Creator 4.13.2 in Qt Creator 10.0.0?
I am currently trying to use the Doxygen plugin in Qt Creator 10.0.0. However, I have encountered compatibility ...
0
votes
0
answers
19
views
Doxygen @ref does not generate reference for #define macro-definitions in one file
I have a problem with @ref in oxygen documentation. In function description I have:
Doxygen 1.9.6
/// @param dwOptions type of allocation (0 - no special options needed, @ref ALLOCOPTION_FROM_ISR, @...
-1
votes
1
answer
34
views
How can I remove the '?' from my (HTML page) documentation with Doxygen?
I am trying to use Doxygen to have the documentation of my C++ code. The installation is ok and I can run DoxyWizard but I obtain a lot of characters '?' in my HTML page.
How to fix it ?
Characters in ...
0
votes
1
answer
50
views
chm help file generated by doxygen can't display its content
chm file generated by doxygen displays incorrectly.
I'm trying to compile a chm help file using doxygen, all the html files were generated without any problem. The chm file was generated too (even ...
0
votes
0
answers
13
views
How to insert html character encodings into Doxygen?
I'd really love to be able to insert, for instance, ​ or <wbr> or any other codepoint that will make the documentation more expressive or look nicer.
For instance the word break ...
0
votes
1
answer
42
views
Is it possible to use CSS counter-set to assign chapter numbers to Doxygen files separately?
Is there any way to add CSS code to individual Doxygen pages
Writing a specification in Doxygen, I subdivide the overall document into multiple chapters, each contained into one Doxygen file. I now ...
0
votes
0
answers
21
views
How to get rid of the @copydoc warning when producing code documentation using Doxygen?
I'm using Ubuntu 22.04.2 LTS and doxygen 1.9.1.
When producing code documentation using Doxygen, I receive the following warning:
solver/linear/storage/aim/VrbBlkCompressedMCSRMatrix.h:66: warning: @...
0
votes
0
answers
21
views
Doxygen 1.8.5: (1) How to properly process *.hh C++ files. (2) How to use multiple patterns with FILE_PATTERNS
I have two problems with Doxygen 1.8.5.
I'm running Doxygen by using a dconfig file.
(1) I am forced to use *.cpp, *.h, *.hh, *.inc, and *.f separately when setting FILE_PATTERNS in the dconfig file. ...
0
votes
0
answers
46
views
Doxygen, How to document function pointers in a typedef struct
Doxygen v1.9.6
I have a typedef struct with function pointers in my header file a.h
/**
* @defgroup _xModule X Module
* Generic documentation for this module goes here.
* @{
* @ingroup _mainModule
...
0
votes
0
answers
37
views
finding bad usage of doygen own tags
I'm using doxygen and have defined my own tags in the doxyfile.
Now I want to parse for correct usage of the tags e.g. no blank after mytag.
@mytag{correct}
@mytag {incorrect}
and other ...
0
votes
0
answers
23
views
How to have Doxygen skip the mention to Base class in the Derived method signatures?
I have the following classes
namespace detail{
template<class T>
class Base{
/// @brief A foo method
void foo(){}
};
}
/// @brief A derived class
template<class T>
...
0
votes
0
answers
36
views
How to have Doxygen correctly identify a C++ template partial specialization class symbol and link to its documentation
I have this code:
template <class V, class E> class bar {}; // primary
/// @brief Integer specialization 0
template <> class bar<int, int> {};
/// @brief Partial Integer ...
0
votes
0
answers
37
views
Omit functions not included in group
I have created group exp in doxygen comments in code below and added function add details. Group was created in documentation in Modules, but it also includes function showInt() without detailing. Why ...
0
votes
1
answer
52
views
External command/exclude everything except
Is there any possibility to exclude all documented functions, classes, pages from the output, except those who are specially labelled?
I have a well-documented (big) project. Most of the functions and ...
0
votes
0
answers
45
views
Skip functions without doxygen comments from documentation
Code below shows cpp file that contains two function add (has doxygen comments) and showInt (no doxygen comments). Currently both function appears in Doxygen documentation. Is it possible to ask ...
0
votes
0
answers
34
views
Skip includes from documentation
I'm using Doxygen for my c++ library project. I would like to skip header include information with dependency graph from documentation. How to achieve that?
UPD
Need to omit:
0
votes
1
answer
29
views
In Doxygen, how do I overwrite a group title to remove the group warning saying "ignoring title %s that does not match old title %s"?
P.S. I am a doxygen newbie.
I have a few .c and .h files with a doxygen group format looking like this:
/** \addtogroup <label> <title>
* @{
*/
...
/** @}*/
When built, a warning ...
0
votes
1
answer
29
views
Doxygen for Python produces bad formatting since an update
I'm using doxygen for a while to document my project. However in a new computer with a newer version of doxygen (1.9.1) it produces bad formatting for function docstrings.
I attach an image that ...
0
votes
1
answer
30
views
Cannot use autodoxygen more than 1 time
I cannot use autodoxygenfile more than once in a single markdown file or in multiple files.
My project structure is as like as follows:
project/include/color/a.h
/shape/b.h
project/...
0
votes
0
answers
49
views
No HTML replacement with a Doxygen \verbatim block for XML output
The Problem
I have the following snippet in one of my headers:
/**
* @brief Simple function.
*
* @verbatim
* don't want the following to be rendered as <: > or \> !
* @...
0
votes
0
answers
22
views
Doxygen preprocessor modifiys/does not show correct defines inside a @code block on html page
Hello i have problem with the doxygen preprocessor. I have my documentation inside a .dox file. And i want to look at the dox in firefox, Doxygen is version 1.8.5 and cannot be changed
My Doxfile.incl ...
0
votes
0
answers
14
views
LateX output of Doxygen - order of chapters
I am trying to modify the order of chapters in the LaTeX output of Doxygen - analogous to the Layout file available for the html output, which allows the order to be customized. But for the LaTeX (...
0
votes
0
answers
37
views
Include content of a page inside one markdown file in another markdown file when generating documentation using Doxygen
I am using markdown file (*.md) and Doxygen tool to process these files and generate documentation.
File1.md
Some content A
Some content B
\page ABC Title of ABC
Then I am using \subpage to include ...
0
votes
0
answers
64
views
LaTeX errors from Doxygen Output - Undefined tab position
I am getting LaTeX Error: Undefined tab position, and pdfLatex quits after receving too many (100 errors). My LaTeX generated by Doxygen is such (one instance of many)
\begin{tabbing}
xx\=xx\=xx\=xx\=...
0
votes
0
answers
39
views
How to make Doxygen hide the "class" name in a list of functions?
I am using Doxygen to document the c API of a library. The API is pseudo, as c doesn't have classes, object oriented. My function names are all of the form className_MethodName(...). I use \class to ...
0
votes
0
answers
31
views
I want to embed a uml activity Diagram
I am trying to create an activity diagram of my code by embedding the UML syntax in code and using Doxygen with plant UML.
this is my code
int add_numbers(int a, int b) {
/** @startuml*/
/** ...
0
votes
1
answer
42
views
Doxygen code sections are not properly formatted in pdf file
I have mainpage.dox file, which is used as an introduction page for Doxygen documentation. It contains code sections, like this:
/*! \mainpage My project
*
* \code{.cpp}
* void some_function()
* {
...
1
vote
0
answers
37
views
Why might doxygen fail to generate expected UML output?
I have access to two machines with doxygen setup and working. On one it produces nice boxed uml diagrams, on the other, it outputs something like unrendered dot diagram code. I've tried the same ...
0
votes
0
answers
81
views
How do I specify in Doxygen that C# api is the same as my C++ one?
I have a C++ API with the namespace api. This API is available in C# via SWIG with the namespace api.dotNET.
How can I tell doxygen that both namespaces are equal and should reference the same ...
0
votes
0
answers
45
views
Doxygen Unnamed Bitfields
Currently i am working on structs with unnamed bitfields in Eclipse CDT C/C++ and Arm Cross GCC.
My struct is looking like:
/** @brief Struct to document */
struct mystruct {
/** @brief Member to ...
0
votes
1
answer
44
views
Embedding Doxygen Group/Section/Anchor/etc output onto a Page
My goal is to create a standalone Page that includes sections of code by reference or grouping like in modules. I am aware of Doxygen's ability to provide links to the desired sections, and the ...
0
votes
1
answer
26
views
Doxygen: Generate different content based on certain switch
My code has a compiler switch to support different platforms. I would like to use doxygen to generate different content based on this compiler switch.
#define UsedPlatform PlatformA
Is there anything ...
0
votes
0
answers
46
views
Generate docstrings/documentation for modified interfaces that use typemaps (C->Swig->Python)
I have been exploring auto-generating documentation for swig interfaces. Using a backend C file with doxygen comments and generating python interfaces.
I have been unable to capture typemaps in the ...
0
votes
0
answers
57
views
Auto-generate documentation *only* after build workflow?
I've made a habit of providing a documentation-generating target to my CMake projects, which generate a custom Doxyfile from metada stored in CMake variables (such as project name, description and ...
0
votes
0
answers
130
views
How to generate a global function call graph for an entire C++ project
The project contains multiple C++ files and contains multiple entry points. I want to generate a global function call graph for the entire project, which contains the functions in all the files in the ...
1
vote
1
answer
58
views
how to exclude .git from doxygen
I am new to Doxygen and recently came across an issue on how to exclude .git folder from being searched by Doxygen.
Neither
EXCLUDE = .git
nor
EXCLUDE_PATTERNS = */.git/*
work.
This does seem like ...
0
votes
0
answers
50
views
Brew Install of doxygen is failing due to Cloudflare page validation
When I try to install doxygen via:
brew install doxygen
I get a a SHA256 mismatch error:
Downloading https://doxygen.nl/files/doxygen-1.9.6.src.tar.gz
##O=# # ...
1
vote
1
answer
91
views
Adding images to Doxygen
I am trying to add an image to a doxygen .md file. Easy enough.
It needs to have a caption. Easy enough.
It needs to be left aligned. Err. This is where I am struggling.
I can add a caption or left ...
0
votes
1
answer
13
views
How can I add the description of a module inside the module table of contant
I have my code organized as follows
Header files:
/**
* @defgroup alternator_controller Alternator Controller
* @ingroup application_layer
* @file alternator_controller.h
* @{
*/
/* ...
2
votes
1
answer
199
views
How to extract and map function names and and their comments from C-header files?
I have many different .h files in different formats. They include function definitions, variable definitions and more. My goal is to extract all function names and their respective comments and map ...
0
votes
0
answers
59
views
Appending to doxygen function documentation C++ instead of replacing
Currently using Doxygen 1.8.13
We have:
abstract base/interface class
multiple implementation classes
need to generate external and more detailed internal documentation (driven by ASPICE requirements)...
0
votes
1
answer
45
views
Doxygen does not parse __attribute__ correctly
I have some functions defined the following way:
* @brief Obtains the current time tick of the OS.
* This is a weak function and is intended to be overridden.
* @return In the weak ...
1
vote
0
answers
35
views
How to get links to namespaced enums to work with Doxygen
I am having trouble getting a link to an enum to work with Doxygen.
With the files below the link of the return value to the Status enum for someFunction works inside the namespace documentation file,...