Q:

Issue with doxygen .dox files

I am trying to run doxygen on some source files for a project that I downloaded source files for. The files are located in the following directories:

doc/ - Documentation files, such as .dox files.
src/ - Source files

My settings in my doxygen.config file are:
INPUT                  = ../ .

FILE_PATTERNS          = *.h *.dox *.dxx

When I run doxygen (doxygen doxygen.config), it generates all of the documentation from the .h files correctly, but it does not generate the mainpage correctly. I have a file titled intro.dox in the doc folder, with a command \mainpage Documentation Index, and a bunch of text, but doxygen is not using this to generate the main page.
What am I doing wrong?

A:

There are (at least) two possible reasons for this:

You are not including the /doc directory in you INPUT list. Try modifying this to
INPUT = ../ . ../doc

Did you mean to write ../doc instead of ../? I am guessing that your doxygen.config file is in your src directory. If this is not the case can you make this clear in the question.
Doxygen requires that your documentation files (your .dox files) are plain text with your text wrapped with Doxygen C++ comments (i.e. /** ... */).

