[libsigc++2] Disable extraction of undocumented identifiers



commit 058b4cdb5b839ddfc3386416643c50f87b181c81
Author: Daniel Elstner <danielk openismus com>
Date:   Sat Aug 8 19:06:11 2009 +0200

    Disable extraction of undocumented identifiers
    
    * docs/reference/Doxyfile.in (EXTRACT_ALL): Change setting to
    NO, and adapt a number of related options accordingly.  The
    result is a net loss of about 300 generated .html files.  The
    roughly 450 files which remain now are still an insanely high
    number, though.
    (PREDEFINED): Predefine the Autoconf configuration defines to
    nudge Doxygen towards documenting the canonical code paths.

 ChangeLog                  |   12 ++++++++++++
 docs/reference/Doxyfile.in |   41 +++++++++++++++++++++++------------------
 2 files changed, 35 insertions(+), 18 deletions(-)
---
diff --git a/ChangeLog b/ChangeLog
index e746991..2ebe37e 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,15 @@
+2009-08-08  Daniel Elstner  <danielk openismus com>
+
+	Disable extraction of undocumented identifiers
+
+	* docs/reference/Doxyfile.in (EXTRACT_ALL): Change setting to
+	NO, and adapt a number of related options accordingly.  The
+	result is a net loss of about 300 generated .html files.  The
+	roughly 450 files which remain now are still an insanely high
+	number, though.
+	(PREDEFINED): Predefine the Autoconf configuration defines to
+	nudge Doxygen towards documenting the canonical code paths.
+
 2009-08-07  Daniel Elstner  <danielk openismus com>
 
 	Use #error explicitly instead of broken code
diff --git a/docs/reference/Doxyfile.in b/docs/reference/Doxyfile.in
index 826b9e9..5b8155b 100644
--- a/docs/reference/Doxyfile.in
+++ b/docs/reference/Doxyfile.in
@@ -16,13 +16,9 @@ ABBREVIATE_BRIEF       =
 ALWAYS_DETAILED_SEC    = NO
 INLINE_INHERITED_MEMB  = NO
 FULL_PATH_NAMES        = YES
-STRIP_FROM_PATH        = "@abs_top_builddir@/sigc++/" \
-                         "@abs_top_srcdir@/sigc++/" \
-                         "@abs_top_builddir@/" \
+STRIP_FROM_PATH        = "@abs_top_builddir@/" \
                          "@abs_top_srcdir@/"
-STRIP_FROM_INC_PATH    = "@abs_top_builddir@/sigc++/" \
-                         "@abs_top_srcdir@/sigc++/" \
-                         "@abs_top_builddir@/" \
+STRIP_FROM_INC_PATH    = "@abs_top_builddir@/" \
                          "@abs_top_srcdir@/"
 SHORT_NAMES            = NO
 JAVADOC_AUTOBRIEF      = YES
@@ -48,15 +44,15 @@ SYMBOL_CACHE_SIZE      = 0
 #---------------------------------------------------------------------------
 # Build related configuration options
 #---------------------------------------------------------------------------
-EXTRACT_ALL            = YES
+EXTRACT_ALL            = NO
 EXTRACT_PRIVATE        = NO
-EXTRACT_STATIC         = YES
-EXTRACT_LOCAL_CLASSES  = YES
+EXTRACT_STATIC         = NO
+EXTRACT_LOCAL_CLASSES  = NO
 EXTRACT_LOCAL_METHODS  = NO
 EXTRACT_ANON_NSPACES   = NO
 HIDE_UNDOC_MEMBERS     = NO
-HIDE_UNDOC_CLASSES     = NO
-HIDE_FRIEND_COMPOUNDS  = NO
+HIDE_UNDOC_CLASSES     = YES
+HIDE_FRIEND_COMPOUNDS  = YES
 HIDE_IN_BODY_DOCS      = YES
 INTERNAL_DOCS          = NO
 CASE_SENSE_NAMES       = YES
@@ -67,10 +63,10 @@ SORT_MEMBER_DOCS       = YES
 SORT_BRIEF_DOCS        = NO
 SORT_GROUP_NAMES       = NO
 SORT_BY_SCOPE_NAME     = YES
-GENERATE_TODOLIST      = YES
-GENERATE_TESTLIST      = YES
-GENERATE_BUGLIST       = YES
-GENERATE_DEPRECATEDLIST= YES
+GENERATE_TODOLIST      = NO
+GENERATE_TESTLIST      = NO
+GENERATE_BUGLIST       = NO
+GENERATE_DEPRECATEDLIST= NO
 ENABLED_SECTIONS       =
 MAX_INITIALIZER_LINES  = 2
 SHOW_USED_FILES        = YES
@@ -229,9 +225,18 @@ INCLUDE_PATH           = "@abs_top_builddir@" \
 INCLUDE_FILE_PATTERNS  = *.h
 PREDEFINED             = __cplusplus \
                          DOXYGEN_SHOULD_SKIP_THIS \
-                         SIGC_USING_STD(x)= \
-                         SIGC_API=
-EXPAND_AS_DEFINED      =
+                         "SIGC_API=" \
+                         SIGC_CONFIGURE \
+                         SIGC_GCC_TEMPLATE_SPECIALIZATION_OPERATOR_OVERLOAD \
+                         SIGC_HAVE_NAMESPACE_STD \
+                         SIGC_MSVC_TEMPLATE_SPECIALIZATION_OPERATOR_OVERLOAD \
+                         SIGC_SELF_REFERENCE_IN_MEMBER_INITIALIZATION \
+                         SIGC_TEMPLATE_SPECIALIZATION_OPERATOR_OVERLOAD \
+                         "SIGC_USING_STD(Symbol)="
+EXPAND_AS_DEFINED      = SIGC_WORKAROUND_OPERATOR_PARENTHESES \
+                         SIGCXX_MAJOR_VERSION \
+                         SIGCXX_MINOR_VERSION \
+                         SIGCXX_MICRO_VERSION
 SKIP_FUNCTION_MACROS   = YES
 #---------------------------------------------------------------------------
 # Configuration::additions related to external references



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]