updated: doxygen "build" script.

git-svn-id: https://xbmc.svn.sourceforge.net/svnroot/xbmc/trunk@28615 568bbfeb-2a22-0410-94d2-cc84cf5bfa90
koying · Mar 17, 2010 · 9b49d0e · 9b49d0e
1 parent 6ad3267
commit 9b49d0e
Show file tree

Hide file tree

Showing 3 changed files with 158 additions and 176 deletions.
diff --git a/doxygen_resources/Doxyfile.doxy b/doxygen_resources/Doxyfile.doxy
@@ -1,4 +1,4 @@
-# Doxyfile 1.6.1
+# Doxyfile 1.6.3
 
 # This file describes the settings to be used by the documentation system
 # doxygen (www.doxygen.org) for a project
@@ -397,6 +397,12 @@ HIDE_SCOPE_NAMES       = NO
 
 SHOW_INCLUDE_FILES     = YES
 
+# If the FORCE_LOCAL_INCLUDES tag is set to YES then Doxygen 
+# will list include files with double quotes in the documentation 
+# rather than with sharp brackets.
+
+FORCE_LOCAL_INCLUDES   = NO
+
 # If the INLINE_INFO tag is set to YES (the default) then a tag [inline] 
 # is inserted in the documentation for inline members.
 
@@ -584,7 +590,7 @@ WARN_LOGFILE           =
 # directories like "/usr/src/myproject". Separate the files or directories 
 # with spaces.
 
-INPUT                  = ../xbmc/utils \
+INPUT                  = ../xbmc \
                          ../guilib \
                          .
 
@@ -645,7 +651,8 @@ RECURSIVE              = YES
 # excluded from the INPUT source files. This way you can easily exclude a 
 # subdirectory from a directory tree whose root is specified with the INPUT tag.
 
-EXCLUDE                = ../guilib/tinyXML
+EXCLUDE                = ../guilib/tinyXML \
+                         ../xbmc/lib
 
 # The EXCLUDE_SYMLINKS tag can be used select whether or not files or 
 # directories that are symbolic links (a Unix filesystem feature) are excluded 
@@ -659,7 +666,11 @@ EXCLUDE_SYMLINKS       = NO
 # against the file with absolute path, so to exclude all test directories 
 # for example use the pattern */test/*
 
-EXCLUDE_PATTERNS       = */.svn/*
+EXCLUDE_PATTERNS       = */.svn/* \
+                         */.svn \
+                         */lib*/* \
+                         */*Codec/* \
+                         doxygen.hpp
 
 # The EXCLUDE_SYMBOLS tag can be used to specify one or more symbol names 
 # (namespaces, classes, functions, etc.) that should be excluded from the 
@@ -840,6 +851,12 @@ HTML_FOOTER            =
 
 HTML_STYLESHEET        = 
 
+# If the HTML_TIMESTAMP tag is set to YES then the footer of each generated HTML 
+# page will contain the date and time when the page was generated. Setting 
+# this to NO can help when comparing the output of multiple runs.
+
+HTML_TIMESTAMP         = YES
+
 # If the HTML_ALIGN_MEMBERS tag is set to YES, the members of classes, 
 # files or namespaces will be aligned in HTML using tables. If set to 
 # NO a bullet list will be used.
@@ -941,7 +958,7 @@ QCH_FILE               =
 # Qt Help Project output. For more information please see 
 # http://doc.trolltech.com/qthelpproject.html#namespace
 
-QHP_NAMESPACE          = 
+QHP_NAMESPACE          = org.doxygen.Project
 
 # The QHP_VIRTUAL_FOLDER tag specifies the namespace to use when generating 
 # Qt Help Project output. For more information please see 
@@ -973,6 +990,23 @@ QHP_SECT_FILTER_ATTRS  =
 
 QHG_LOCATION           = 
 
+# If the GENERATE_ECLIPSEHELP tag is set to YES, additional index files  
+# will be generated, which together with the HTML files, form an Eclipse help  
+# plugin. To install this plugin and make it available under the help contents 
+# menu in Eclipse, the contents of the directory containing the HTML and XML 
+# files needs to be copied into the plugins directory of eclipse. The name of 
+# the directory within the plugins directory should be the same as 
+# the ECLIPSE_DOC_ID value. After copying Eclipse needs to be restarted before
+# the help appears.
+
+GENERATE_ECLIPSEHELP   = NO
+
+# A unique identifier for the eclipse help plugin. When installing the plugin 
+# the directory name containing the HTML and XML files should also have 
+# this name.
+
+ECLIPSE_DOC_ID         = org.doxygen.Project
+
 # The DISABLE_INDEX tag can be used to turn on/off the condensed index at 
 # top of each HTML page. The value NO (the default) enables the index and 
 # the value YES disables it.
@@ -1013,15 +1047,26 @@ TREEVIEW_WIDTH         = 250
 
 FORMULA_FONTSIZE       = 10
 
-# When the SEARCHENGINE tag is enable doxygen will generate a search box
+# When the SEARCHENGINE tag is enabled doxygen will generate a search box
 # for the HTML output. The underlying search engine uses javascript 
 # and DHTML and should work on any modern browser. Note that when using
-# HTML help (GENERATE_HTMLHELP) or Qt help (GENERATE_QHP) 
-# there is already a search function so this one should typically 
-# be disabled.
+# HTML help (GENERATE_HTMLHELP), Qt help (GENERATE_QHP), or docsets
+# (GENERATE_DOCSET) there is already a search function so this one should 
+# typically be disabled. For large projects the javascript based search engine 
+# can be slow, then enabling SERVER_BASED_SEARCH may provide a better solution.
 
 SEARCHENGINE           = NO
 
+# When the SERVER_BASED_SEARCH tag is enabled the search engine will be
+# implemented using a PHP enabled web server instead of at the web client
+# using Javascript. Doxygen will generate the search PHP script and index 
+# file to put on the web server. The advantage of the server
+# based approach is that it scales better to large projects and allows
+# full text search. The disadvances is that it is more difficult to setup 
+# and does not have live searching capabilities.
+
+SERVER_BASED_SEARCH    = NO
+
 #---------------------------------------------------------------------------
 # configuration options related to the LaTeX output
 #---------------------------------------------------------------------------
@@ -1038,7 +1083,10 @@ GENERATE_LATEX         = NO
 LATEX_OUTPUT           = latex
 
 # The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be 
-# invoked. If left blank `latex' will be used as the default command name.
+# invoked. If left blank `latex' will be used as the default command name. 
+# Note that when enabling USE_PDFLATEX this option is only used for 
+# generating bitmaps for formulas in the HTML output, but not in the 
+# Makefile that is written to the output directory.
 
 LATEX_CMD_NAME         = latex
 

diff --git a/doxygen_resources/pages/mainpage.dox b/doxygen_resources/pages/mainpage.dox
@@ -9,13 +9,110 @@
             and we welcome any and all input to documenting it further. Documentation serves both to help
             newcomers get to grips with the source quickly, and to highlight possible deficiencies in the
             code or interfaces.
-
-            Currently the doxygen configuration file is set to only document the "xbmc\utils" directory,
-            though the ultimate goal is to document the public interface of everything.
 
             Any help/suggestions are more than welcome.
 
   \section  doxy_whatisxbmc What is XBMC?
             XBMC is a free, open source (GPL) multimedia player that runs on Linux, Mac OS X (10.4 and later),
             AppleTV and Windows.  See http://xbmc.org for more details.
 */
+
+// Groups definition
+
+///////////////////////////////////////
+//
+// xbmc project
+//
+///////////////////////////////////////
+
+/*!
+	\defgroup windows XBMC windows
+
+	XBMC windows
+*/
+
+/*!
+	\defgroup music Music info
+
+	Elements used in my music
+*/
+
+
+//////////////////////////////////////
+//
+// guilib project
+//
+//////////////////////////////////////
+
+/*!
+	\defgroup guilib guilib classes
+
+	guilib classes
+*/
+
+/*!
+	\defgroup winref Window Reference
+	\ingroup guilib
+
+	The window reference
+*/
+
+/*!
+	\defgroup winmsg Windows and Messages
+	\ingroup winref
+	Windows and messages
+*/
+
+/*!
+	\defgroup controls Controls
+	\ingroup winref
+	Control classes
+*/
+
+/*!
+	\defgroup winman Window Manager and Callbacks
+	\ingroup winref
+
+	Everything about window manager and callbacks
+*/
+
+/*!
+	\defgroup actionkeys Actions and Keys
+	\ingroup winref
+
+	Everything around action mapping and key processing
+*/
+
+/*!
+	\defgroup graphics Graphics and Screen
+	\ingroup guilib
+
+	Everything around graphics and Screen
+*/
+
+/*!
+	\defgroup textures Textures and Fonts
+	\ingroup graphics
+
+	Everything about textures and fonts
+*/
+
+/*!
+	\defgroup strings Strings and Localization
+	\ingroup guilib
+
+	Everything around Strings and localization
+*/
+
+/*!
+	\defgroup tinyxml XML Parser
+	\ingroup strings
+
+	Tiny XML - XML Parser
+*/
+
+/*!
+	\defgroup jobs Asynchronous jobs
+
+	Threaded job execution
+*/