You should use the \mainpage command inside a comment block like this:
/*! \mainpage My Personal Index Page * * \section intro Introduction * * This is the introduction. * * \section install Installation * * \subsection step1 Step 1: Opening the box * * etc... */
You can use Doxygen's preprocessor for this: If you put
#ifndef DOXYGEN_SHOULD_SKIP_THIS /* code that must be skipped by Doxygen */ #endif /* DOXYGEN_SHOULD_SKIP_THIS */
PREDEFINED = DOXYGEN_SHOULD_SKIP_THIS
PREPROCESSING = YES
.
Look at section Preprocessing for the answer.