# Generation switches
 #---------------------------------------------------------------------------
 
-GENERATE_HTMLHELP      = YES
-GENERATE_HTML          = YES
-GENERATE_XML           = YES
+# This file generates all the official formats we distribute.
 
+GENERATE_HTML          = YES
+GENERATE_HTMLHELP      = YES
 GENERATE_LATEX         = NO
 GENERATE_RTF           = NO
 GENERATE_MAN           = NO
-GENERATE_PERLMOD       = YES
+GENERATE_XML           = YES
 GENERATE_AUTOGEN_DEF   = NO
-GENERATE_TAGFILE       =
+GENERATE_PERLMOD       = YES
+GENERATE_TAGFILE       = NO
 
-# see Doxyfile_chm for more info about hhc.exe and where to get it!
-HHC_LOCATION           = hhc.exe
 
 
 @INCLUDE = Doxyfile_inc
 
+# HTML Help Compiler (hhc.exe) is the compiler used to produce CHM files from
+# the HTML sources. You are required to install HHC to generate this format.
+#
+# Windows:
+#   You can download it for free from MS website:
+#   <http://www.microsoft.com/downloads/details.aspx?FamilyID=00535334-c8a6-452f-9aa0-d597d16580cc&displaylang=en>
+#   Then set the HHC_PATH environment variable to the folder where you
+#   installed HHC. See <http://www.computerhope.com/issues/ch000549.htm>
+#   for more info about how to set env variables in WinXP or newer.
+#
+# Unix:
+#   You can install the Windows version of the compiler under WINE
+#   <http://www.winehq.org/> following the instructions placed here:
+#   <http://appdb.winehq.org/objectManager.php?sClass=application&iId=2140>
+#   Then place the hhc.exe executable in your PATH. You can add to your
+#   ~/.bashrc (if you use bash):
+#     PATH=$PATH:~/.wine/drive_c/Program Files/HTML Help Workshop
+#     export PATH
+
 #---------------------------------------------------------------------------
 # Generation switches
 #---------------------------------------------------------------------------
 
-GENERATE_HTMLHELP      = YES
-
-# NOTE: the following must be set to YES otherwise doxygen won't generate the 
+# NOTE: GENERATE_HTML must be set to YES otherwise doxygen won't generate the
 #       index.hhp file and the CHM compilation will fail!
 GENERATE_HTML          = YES
-GENERATE_XML           = NO
-
-GENERATE_LATEX         = NO
-GENERATE_RTF           = NO
-GENERATE_MAN           = NO
-GENERATE_PERLMOD       = NO
-GENERATE_AUTOGEN_DEF   = NO
-GENERATE_TAGFILE       =
+GENERATE_HTMLHELP      = YES
 
-# Notes about the HTML HELP COMPILER (hhc):
-# hhc is the compiler used to produce CHM files from the HTML sources.
-#
-# => for Windows:
-#    you can download it for free from MS website:
-#      http://www.microsoft.com/downloads/details.aspx?FamilyID=00535334-c8a6-452f-9aa0-d597d16580cc&displaylang=en
-#    then set the HHC_PATH environment variable to the folder where you
-#    installed HHC; see e.g. http://www.computerhope.com/issues/ch000549.htm
-#    for more info about how to set env variables in WinXP or newer.
-#
-# => for Unix: 
-#    you can install the Windows version of the compiler under WINE 
-#    (http://www.winehq.org/) following the instructions placed here:
-#      http://appdb.winehq.org/objectManager.php?sClass=application&iId=2140
-#    then you can place hhc.exe executable in your PATH; e.g. you can add to
-#    your ~/.bashrc (if you use bash): 
-#      PATH=$PATH:~/.wine/drive_c/Programmi/HTMLHelpWorkshop
-#      export PATH
-#
-HHC_LOCATION           = hhc.exe
 
 # Generation switches
 #---------------------------------------------------------------------------
 
-GENERATE_HTMLHELP      = NO
 GENERATE_HTML          = YES
-GENERATE_XML           = NO
+SEARCHENGINE           = YES
 
-GENERATE_LATEX         = NO
-GENERATE_RTF           = NO
-GENERATE_MAN           = NO
-GENERATE_PERLMOD       = NO
-GENERATE_AUTOGEN_DEF   = NO
-GENERATE_TAGFILE       =
-
-HHC_LOCATION           =
 
 #---------------------------------------------------------------------------
 # configuration options related to the HTML output
 #---------------------------------------------------------------------------
+GENERATE_HTML          = NO # Only change in format output configs
 HTML_OUTPUT            = html
 HTML_FILE_EXTENSION    = .html
 HTML_HEADER            = htmlheader.inc
 HTML_FOOTER            = htmlfooter.inc
 HTML_STYLESHEET        =
 HTML_ALIGN_MEMBERS     = YES
+GENERATE_HTMLHELP      = NO # Only change in format output configs
 HTML_DYNAMIC_SECTIONS  = YES
-CHM_FILE               = ..\wx.chm      # NOTE: we need to use Win-style separator here
+CHM_FILE               = ..\wx.chm # NOTE: Windows style separator needed
+HHC_LOCATION           = hhc.exe # Don't modify, see Doxyfile_chm for info
 GENERATE_CHI           = NO
 BINARY_TOC             = NO
 TOC_EXPAND             = NO
 #---------------------------------------------------------------------------
 # configuration options related to the LaTeX output
 #---------------------------------------------------------------------------
+GENERATE_LATEX         = NO # Only change in format output configs
 LATEX_OUTPUT           = latex
 LATEX_CMD_NAME         = latex
 MAKEINDEX_CMD_NAME     = makeindex
 #---------------------------------------------------------------------------
 # configuration options related to the RTF output
 #---------------------------------------------------------------------------
+GENERATE_RTF           = NO # Only change in format output configs
 RTF_OUTPUT             = rtf
 COMPACT_RTF            = NO
 RTF_HYPERLINKS         = NO
 #---------------------------------------------------------------------------
 # configuration options related to the man page output
 #---------------------------------------------------------------------------
+GENERATE_MAN           = NO # Only change in format output configs
 MAN_OUTPUT             = man
 MAN_EXTENSION          = .3
 MAN_LINKS              = NO
 #---------------------------------------------------------------------------
 # configuration options related to the XML output
 #---------------------------------------------------------------------------
+GENERATE_XML           = NO # Only change in format output configs
 XML_OUTPUT             = xml
 XML_SCHEMA             =
 XML_DTD                =
 #---------------------------------------------------------------------------
 # configuration options for the AutoGen Definitions output
 #---------------------------------------------------------------------------
-
+GENERATE_AUTOGEN_DEF   = NO # Only change in format output configs
 
 #---------------------------------------------------------------------------
 # configuration options related to the Perl module output
 #---------------------------------------------------------------------------
-GENERATE_PERLMOD       = NO
+GENERATE_PERLMOD       = NO # Only change in format output configs
 PERLMOD_LATEX          = YES
 PERLMOD_PRETTY         = YES
 PERLMOD_MAKEVAR_PREFIX =
 # Configuration::additions related to external references
 #---------------------------------------------------------------------------
 TAGFILES               =
+GENERATE_TAGFILE       =
 ALLEXTERNALS           = NO
 EXTERNAL_GROUPS        = YES
 PERL_PATH              = /usr/bin/perl
 #---------------------------------------------------------------------------
 # Configuration::additions related to the search engine
 #---------------------------------------------------------------------------
-SEARCHENGINE           = YES
+SEARCHENGINE           = NO
+
 
 # Generation switches
 #---------------------------------------------------------------------------
 
-GENERATE_HTMLHELP      = NO
-GENERATE_HTML          = NO
-GENERATE_XML           = NO
-
 GENERATE_LATEX         = YES
-GENERATE_RTF           = NO
-GENERATE_MAN           = NO
-GENERATE_PERLMOD       = NO
-GENERATE_AUTOGEN_DEF   = NO
-GENERATE_TAGFILE       =
 
-HHC_LOCATION           =
 
 # Generation switches
 #---------------------------------------------------------------------------
 
-GENERATE_HTMLHELP      = NO
-GENERATE_HTML          = NO
 GENERATE_XML           = YES
 
-GENERATE_LATEX         = NO
-GENERATE_RTF           = NO
-GENERATE_MAN           = NO
-GENERATE_PERLMOD       = NO
-GENERATE_AUTOGEN_DEF   = NO
-GENERATE_TAGFILE       =
-
-HHC_LOCATION           =
 
        content: "Categories / ";
 }
 
+/* Doxygen defaults the top navigation tabs to a small, bold font,
+   so we reset it here to a larger, normal font. */
 DIV.navigation A SPAN {
-       font-size: 110%;
+       font-size: 120%;
+       font-weight: normal;
 }