Stack Overflow
Stack Overflow

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.

Doxygen is a documentation generation application written by Dimitri van Heesch that supports a wide variety of output formats including RTF, HTML, XML and PDF. It supports code in C++, C, Java, Objective-C, Python, IDL (Corba and Microsoft flavors), Fortran, VHDL, PHP, C#, and to some extent D. It is available for Linux, MacOS and Windows. The application is licenced under the GNU General Public License.

Features of Doxygen

  • Generate documentation in various formats including HTML, XML, LaTex, Man Pages, RTF and PDF.
  • Finegrained configuration possibilities to decide what parts of the code is included in the documentation.
  • Extract the code structure from documented or undocumented source files.
  • A number of different diagrams such as dependency graphs, inheritance diagrams and collaboration diagrams can be generated.
  • Additional documentation pages such as overview, howtos etc. can be included in the documentation structure.
  • Tight integration with the .dot graphic tool enables quick graphing utilities for state diagrams etc.

See Also

2807 questions
51
votes
5 answers

Documenting C++/CLI library code for use from c# - best tools and practices?

I'm working on a project where a c++/cli library is being used primarily from a c# application. Is there any way to make the code comments in c++/cli visible to c# intellisence within visual studio? Assuming there isn't, what would be the best way…
Hrvoje Prgeša
  • 2,021
  • 5
  • 21
  • 36
50
votes
4 answers

Graphviz + Doxygen to generate UML class diagrams

I want to use Graphviz + Doxygen to generate a class diagram based on C++ code. This works already as Doxygen comes with a native DOT support; but is it possible, to produce a UML-like output with the corresponding access modificators (public,…
Eric
  • 1,504
  • 1
  • 15
  • 29
47
votes
4 answers

how to get doxygen to produce call & caller graphs for c functions

I've spent some time reviewing the docs and going through my doxy config file from end to end. I cut doxygen loose on my config file and it produces documentation and indices for structs and cpp classes but I don't see call or caller graphs for the…
user501138
  • 789
  • 1
  • 8
  • 16
47
votes
4 answers

Why does a C comment like /* */ need '<'?

My teams C-code guidelines write that it'd be better to place a '<' in a comment like shown below: #define MAX_PACK_ITEM_NUM 50 /**< max number of item */ I wonder, what is the real use of this '<' ?
kingkai
  • 3,399
  • 3
  • 16
  • 13
47
votes
5 answers

Doxygen \cite producing empty bibliography

I'm trying to use \cite in Doxygen to produce a bibliography page and also a reference within my text. I have bibtex in my search path and a proper .bib file. I have added the .bib file to CITE_BIB_FILES and am using a proper BibTex label found in…
user1401630
  • 861
  • 1
  • 9
  • 9
44
votes
2 answers

Is Sphinx already suitable for C++ documentation?

I want to try out documentation generators for a new project in C++. I think my options are either Doxygen or Sphinx. Since I have projects in Python for which I'd like to use Sphinx, I wonder whether Sphinx is the right choice for C++ as well. The…
clstaudt
  • 17,395
  • 34
  • 132
  • 209
43
votes
6 answers

How to get a single PDF document from Doxygen?

When I generate Doxygen documentation in PDF format, I get plenty of different files with a single diagram in each. Is it possible to obtain a single PDF document, organized as a book, roughly as the HTML version? Is it possible to get it…
Pietro
  • 10,628
  • 22
  • 80
  • 165
42
votes
4 answers

How to integrate examples with Doxygen?

I documented all of my classes and now I want to integrate an example of how to use these classes. How do I do that?
Tobi Weißhaar
  • 1,567
  • 5
  • 24
  • 34
41
votes
6 answers

Can I have my GitHub Pages index.html in a subfolder of the repository?

I'm trying to use GitHub pages to host a Doxygen site. Ideally, I'd like to be able to push the generated files and directories to GitHub without having to tweak them at all. This, however, means that my index.html is in a subfolder of the…
false_azure
  • 1,463
  • 3
  • 22
  • 40
40
votes
3 answers

Custom tags with Doxygen

I am trying to figure out if there is a way to create a custom tag using Doxygen. I did find the ALIAS configuration file option but that does not do exactly what I need. Basically in my code I want to be able to write something like /// \req…
RishiD
  • 1,836
  • 2
  • 22
  • 23
37
votes
3 answers

Documenting enum values with doxygen

Given: namespace Foo { class Foo { public: /// Foo enum, possible ways to foo enum class Foo { /// Foo it with an A A, /// Foo it with a B B, /// Foo it with a C …
Corey Richardson
  • 2,775
  • 2
  • 18
  • 19
36
votes
3 answers

Specify Doxygen parameters through command line

Well I am creating a script to automatically generate documentation for my projects with Doxygen, which seems like an awesome tool. What is not clear to me, is if the user can use specify directly parameters, such as project name, project…
Potney Switters
  • 2,394
  • 3
  • 27
  • 45
34
votes
7 answers

Create "Quick Help" Entry in Xcode

How do I create quick help entries in Xcode for my own code? I just want it as a coding support, meaning like the Eclipse functionality when coding Java. In eclipse you get a comment you entered above a method when hovering a method somewhere…
m Jae
  • 715
  • 2
  • 8
  • 20
34
votes
5 answers

How to publish to Github Pages from Travis CI?

We are compiling Doxygen docs on the travis-ci server and want to push them onto our gh-pages branch. How do I handle the authorization for git push? Does someone have an example for using encrypted variables in travis-ci? Should I go for https…
Stasik
  • 2,430
  • 1
  • 23
  • 40
33
votes
3 answers

A doxygen eclipse plugIn automatically generating stub documentation?

I'am looking for an eclipse-plugin for doxygen code documentation. I have found the eclox-plugIn ( http://home.gna.org/eclox/ ). I would like find out, how can it automatically generate a "empty" doxygen comment, which could be filled out later or…
LonliLokli
  • 1,285
  • 3
  • 14
  • 23
1
2
3
…
99 100