/****************************************************************************** * * $Id$ * * Copyright (C) 1997-1999 by Dimitri van Heesch. * * Permission to use, copy, modify, and distribute this software and its * documentation under the terms of the GNU General Public License is hereby * granted. No representations are made about the suitability of this software * for any purpose. It is provided "as is" without express or implied warranty. * See the GNU General Public License for more details. * * All output generated with Doxygen is not covered by this license. * */ /*! \page faq Frequently Asked Questions
  1. How do get information on the index page in HTML?

    You should use the \\mainpage command inside a comment block like this: \verbatim /*! \mainpage My Personal Index Page * * \section intro Introduction * * This is the introduction. * * \section install Installation * * \subsection step1 Step 1: Opening the box * * etc... */ \endverbatim

  2. How can I avoid that some code fragment is parsed by Doxyen?

    You can use Doxygen's preprocessor for this: If you put \verbatim #ifndef DOXYGEN_SHOULD_SKIP_THIS /* code that must be skipped by Doxygen */ #endif /* DOXYGEN_SHOULD_SKIP_THIS */ \endverbatim around the blocks that should be hidden and put: \verbatim PREDEFINED = DOXYGEN_SHOULD_SKIP_THIS \endverbatim in the config file then all blocks should be skipped by Doxygen as long as PREPROCESSING = YES.

  3. How can I make doxygen ignore nasty macro's? Look at section \ref preprocessing for the answer.
*/