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.
2,978
questions
1
vote
0
answers
17
views
Documenting constants with Doxygen in C
I have various groups of constants in a C .h file that I'd like to document with Doxygen.
Example: axis, direction, possible values.
#define TYPE_LAT 0x01
#define TYPE_LONG 0x02
#define NORTH 0x01
#...
0
votes
1
answer
15
views
Use doxygen to ^create^ README.md?
Many people document applications in the source files themselves, e.g. https://github.com/docopt/docopt.cpp . In the spirit of DRY (don't repeat yourself), I would like source documentation to appear ...
0
votes
1
answer
19
views
Doxygen generates a strange error for base class function about nonexisting function in the derived class
Here is the code:
namespace Test {
/// Base class
class Base
{
public:
/// Method foo
/// @param a ParamA
/// @param b ParamB
virtual void foo(char a, int b);
/// Method foo
//...
0
votes
1
answer
44
views
Doxygen With Flutter
dose any one used doxygen to generate a Documentation for flutter project before ,
I know about dartdoc extension , but I need to generate it with doxygen format ,
I found someone generated a doc for ...
0
votes
0
answers
9
views
No search in official doxygen documentation?
I was wondering how I can do something with doxygen so I tried to find out on the official doxygen site at https://doxygen.nl. As none of the neaders seemed to help, I thought I would use search to ...
4
votes
2
answers
54
views
How can I show a comment block inside a code block inside a doxygen block?
Let's say I want to show a /* - */ delimited comment block inside a code block in a
Doxygen documentation block in C++ code. If the Doxygen block, is itself /* - */
delimited, like this,
/**
...
0
votes
1
answer
23
views
Is there a way to specify a colour scheme for GraphViz dots in Doxygen?
The default scheme isn't very bright and dots has different schemes that can be set when making graphs from the command-line. Doxygen exposes DOT_FONTNAME to pass a font argument to dots but doesn't ...
1
vote
0
answers
35
views
How to comment struct fields in c for doxygen?
This method to document the fields of a struct does not work for me:
typedef struct wigrec {
/** next entry in list */ wigptr next;
...
However this does:
typedef struct wigrec {
/// next ...
0
votes
0
answers
17
views
How to get portable link to Doxygen generated section "Examples"?
When examples are included in the generated docs (via @example tag) they are all collected by Doxygen in a list in the generated docs in the section "Examples". In the documentation one can ...
0
votes
1
answer
18
views
Doxygen does not document variables after variable with attribute
I have a .c file where several variables are declared. One of them has the attribute __align(4), i.e. the declaration is __align(4) static uint32_t myVar;
When I create the doxygen doc for this source ...
0
votes
0
answers
12
views
Use @remark inside @retval section
Is it possible to use the @remark Special Command inside a @retval block without leaving the @retval paragraph?
Example:
...
* @retval res @li Some text
* @li Some ...
-1
votes
0
answers
30
views
'cmake' is not recognized as an internal or external command building doxygen
I am getting this error
C:\Users\xxx>cd doxygen
C:\Users\xxx\doxygen>mkdir build
C:\Users\xxx\doxygen>cd build
C:\Users\xxx\doxygen\build>
C:\Users\xxx\doxygen\build>cmake -G "...
0
votes
0
answers
16
views
Doxygen remove Macro Definition Documentation
I use Doxygen version 1.9.3.
I have a c file :
#define l 20;
#define n 30;
#define k 40;
static void func1(int a, int b)
{
printf("a %d",a);
}
int func2(int x )
{
return x;
}
...
0
votes
0
answers
45
views
Doxygen latex to PDF error: TeX capacity exceeded, sorry [pool size=2851623]
I am using Doxygen to document a large project.
I use Doxygen- 1.9.3 ,MikTeX - 22.3, MiKTeX-pdfTeX 4.10 .
I have a Latex output and run the make.bat batch file to create a PDF file.
During the running ...
0
votes
0
answers
9
views
Remove Doxygen Clutter
I am using Doxygen to generate documentation for my project and I have a small issue. The report ignores folders specified, but still creates a huge header that links to code in the folders that I ...
0
votes
0
answers
13
views
In Doxygen for a C++ project how do I get documentation for member functions that are #included in this nonstandard way?
I have a class that has a #include inside it containing the member function declarations, like this:
class PContextActions_t {
public:
#define PARG blah...
#include "pActionDecls.h"
#undef ...
0
votes
1
answer
31
views
Is there a way to avoid generating "modules" root item from the treeview in doxygen?
I love the flexibility module-grouping gives you to customize the document structure. I am wondering if there is any way (configuration or custom code) to remove the automatically created "...
0
votes
1
answer
32
views
Doxygen: document a class in the cpp file with separate source and header directories while using macros to define namespaces
I'm trying to document a library with the following files:
include/mylib/mylib_global.h
include/mylib/SomeClass.h
source/SomeClass.cpp
Doxyfile
include/mylib/mylib_global.h:
#pragma once
#define ...
0
votes
1
answer
23
views
Doxygen documentation of Fortran77 code (no line breaks, parameters not documented)
I want to write a comment before a Fortran77 routine (main or another subroutine), where the Doxygen (version 1.9.0) comment lines should appear in the Doxygen HTML documentation as in the source code ...
0
votes
0
answers
10
views
Is there a way to produce documentation only in HTML format with doxygen?
I know that doxygen creates LaTeX and HTML documenation, is there a way to create only HTML formated doc?
0
votes
0
answers
9
views
How to enable copying code blocks in Doxygen-generated documentation?
I'd love to understand how I can enable a function that allows Doxygen-generated documentation to copy a code block by clicking a button. Currently it seems the user needs to manually move the cursor ...
0
votes
0
answers
15
views
Is there a way to convince Doxygen to parse documentation blocks in an array initialization
I would like to document the elements of an array like the following:
typedef struct Tokens
{
const char *name;
int value;
} Tokens;
/** @addtogroup token_reference
@{
*/
/** @brief The set ...
0
votes
1
answer
61
views
How to (selectively) disable auto-links to examples in Doxygen
I have the following problem: I want to add code examples to my doxygen documentation. It works fine, but I have quite some examples, each of which needs to call the same function, say, myInit(). Now, ...
0
votes
1
answer
47
views
Doxygen -> Doxy2Swig -> pdoc results in duplicate class docstrings
I have a C++ header file (.h) that (through swig) I generate a python module for. My goal is to include the Doxygen documentation from the .h file in the generated .py file, but since I am currently ...
0
votes
0
answers
25
views
Doxygen skip ifdef
I am using doxygen to document my code and I have one concern. I want doxygen to record and disclose the header files. I am using ceedling for my unit tests and I often have to add helper functions ...
1
vote
0
answers
81
views
Why are my doxygen automatic links not working in my examples that use C++ source?
I have a C++ API that I document with Doxygen and C# examples that use that API (we swig the C++ API to make it available to C# users).
I am seeing an issue where my C# example functions do not auto-...
0
votes
0
answers
19
views
Configure the display of inherited members using Doxygen
Documenting some Qt widgets using Doxygen. For the classes I'm documenting, I only want to display QProperties, and not functions or slots. Within each class I am using @cond tags to exclude those ...
1
vote
1
answer
64
views
Doxygen multi line comments
I am new to Doxygen and trying to comment my code.
I have some issue with the comments: my multi line comments appear in a single line and I don't want to use \\n or <br>.
/**
Brief - this is a ...
1
vote
0
answers
23
views
When add comments in a function with Doxygen, can the function name output in the document be customized? [duplicate]
/**
* Set margain
* @param
* @return
*/
JSFUNC_DECL(set_obj_margin_all) {}
Due to the use of macro, in the above code, the real function name is "setMarginAll", how can I output ...
0
votes
0
answers
34
views
Doxygen 1.9.3: Undocumented external namespaces from .tags files are shown in my Namespace index
After some bug squashing I've gotten my first Doxygen setup to build correctly and am now in the process of fixing visual issues with the documentation.
Right off the bat one problem I'm having is ...
0
votes
0
answers
31
views
Doxygen Server-Based Search does not produce any result (even a "no results" portion)
Nothing is showing up after using a server-based search.
Configuration is set as:
SEARCHENGINE = YES
SERVER_BASED_SEARCH = YES
EXTERNAL_SEARCH = NO
After pressing enter and ...
0
votes
0
answers
37
views
Doxygen brief and detailed descriptions only
I have many projects that all use Doxygen. I document everything and guarantee there are no Doxygen warnings. The output is very nice for getting other developers on board and understanding of the ...
0
votes
0
answers
51
views
Linking Doxygen files that are generated by Gitlab pipeline to adoc file
What I am trying to do is to link a documentation made by Doxygen to a file written in adoc format. I was able to do so when everything was on my Desktop. I used:
link:path/to/documentation/...
0
votes
0
answers
12
views
Doxygen processes my files in a subdirectory, but does not show them in the output documentation
Doxygen processes my project, both headers and implementation files, both in the main directory and in a subdirectory, but then in the generated HTML output only the files from the main directory are ...
0
votes
0
answers
40
views
Doxygen C# support about class overload on generic arity
Considering two C# classes, overloaded on their generic arity, I mean: same name, one is generic, the other is not (but others arity variations may lead to the same issue).
class MyClass { public void ...
0
votes
0
answers
27
views
Organizing Doxygen index list differently/properly
I'm trying to generate properly organized Doxygen documentation for a work project. The issue I'm having is related to the image below:
Everything under the "State Machine" tab are the data ...
0
votes
1
answer
47
views
PlantUml Graphviz generates 2 duplicate diagrams
I have this markdown code that is going to be generated into an html file using plantuml and graphviz.
@image html Module23Static.png TC3
@startuml{Module23Static.png}
caption Module Dependencies ...
0
votes
0
answers
16
views
How to fix Mismatched tag error in XML output
When processing the bignum.h file to XML (or HTML), the tags are not properly ordered. This causes an error with the sphinx breathe parser.
/doxygen/xml\dd/da2/bignum_8h.xml: mismatched tag: line 2599,...
0
votes
1
answer
68
views
Multiline comments in code blocks don't appear in README.md
I am currently documenting how to document code on one of my projects, and to do so I am writing a README.md document that I am putting as frontpage of the documentation that I generate using Doxygen ...
1
vote
1
answer
65
views
How mark parameters in a python docstring for Doxygen
I am confused about the different styles about Python docstrings in the context of Doxygen.
This makes it hard for me to decide if my style is wrong or if I just setup Doxygen the wrong way.
Let me ...
0
votes
0
answers
14
views
Alphabetically sorted Doxygen \xrefitem page
I am using \xrefitem in Doxygen to create a related page. But I would like the page sorted alphabetically from the text instead of from the referenced variable or function names. I have looked at the ...
0
votes
0
answers
35
views
Doxygen (python) ignores module docstrings
I generate the documentation of my Python code from the docstrings via Doxygen (1.9.1) in addition with doxypypy (git version from today).
My problem is that the docstrings of a do not appear in the ...
0
votes
0
answers
34
views
Why does the "package" has a "package" in the Doxygen tree?
I generate the documentation of my Python code from the docstrings via Doxygen (1.9.1) in addition with doxypypy (git version from today).
My project is called Project and the packages name in it (...
0
votes
0
answers
37
views
How to have doxygen output a graph for Modules?
For my project in C I was able to make html documentation by doxygen (version 1.9.3).
Modules are listed in their tab, but clicking on one of them I see only its data structures and, if set up, call ...
0
votes
1
answer
51
views
Doxygen: How to avoid including C++ class source code in the generated html files?
I've created the doxygen project with doxygen wizard for my C++ project. I've found that my header class source code is included in the html documentation. I'd like to avoid this. These files are *...
1
vote
0
answers
15
views
Custom href title in Doxygen?
I've got a glossary topic page that lists terms I want to define. Each term looks like this:
\anchor glossdefinedterm
<dl>
<dt>defined term</dt>
<dd>The defined term is ...
0
votes
0
answers
29
views
How to avoid writing documentation twice for doxygen and argparse?
I'm kind of a newbie in Python and i try to start with good practices. I am currently writing small reusable scripts containing one function and I want them to :
Generate a doc in doxygen
Generate ...
0
votes
1
answer
17
views
Prevent unprocessed DOT files from being deleted when using Doxywizard
I'm using Doxygen wizard to generate documentation for a big embedded C project. I'm able to generate graphs and class diagrams using Dot and Graphviz. However, I would like to edit some dependency ...
0
votes
1
answer
62
views
Doxygen is using an oudated versions of bison and flex
I am trying to install Doxygen. After cloning, I tried the following command
mkdir build
cd build
cmake -G "Unix Makefiles" ..
make
when I run cmake -G "Unix Makefiles" .. , I get ...
1
vote
0
answers
21
views
Doxygen - Latex enumerate list item doesn't show properly
I have generated latex using Doxygen, I want to edit some pages and add an enumerate list in there, when I edit it, it doesn't show properly, it's like being overwritten with text there.
here is the ...