Doxygen won't find headers in subdir

c++ header doxygen
Fred Foo picture Fred Foo · Dec 10, 2010 · Viewed 8.5k times · Source

I'm documenting a C++ library's header files with Doxygen. In the Doxyfile, I defined

INPUT = include/

in the hopes that Doxygen would then generate documentation for all the header files in include/Foo, but it doesn't: only the index.html is generated. I can set INPUT to include/Foo, but then the documentation lists the headers with their basenames (Reader.hh), while I want clients to include the headers as Foo/Reader.hh etc.

How can I get Doxygen to look within the subdirectory?

Answer

basti picture basti · Dec 10, 2010

Have you set RECURSIVE to YES?

# The RECURSIVE tag can be used to turn specify whether or not subdirectories
# should be searched for input files as well. Possible values are YES and NO.
# If left blank NO is used.

RECURSIVE              = YES

it's in the Doxyfile (here line 608, might be sligthly different for you)

Related questions

Using G++ to compile multiple .cpp and .h files

I've just inherited some C++ code that was written poorly with one cpp file which contained the main and a bunch of other functions. There are also .h files that contain classes and their function definitions. Until now the program …

Read More
*.h or *.hpp for your class definitions

I've always used a *.h file for my class definitions, but after reading some boost library code, I realised they all use *.hpp. I've always had an aversion to that file extension, I think mainly because I'm not used to …

Read More
Where does Visual Studio look for C++ header files?

I checked out a copy of a C++ application from SourceForge (HoboCopy, if you're curious) and tried to compile it. Visual Studio tells me that it can't find a particular header file. I found the file in the source tree, …

Read More