diff options
author | Daniel Elstner <daniel.kitta@gmail.com> | 2009-12-28 04:06:00 +0100 |
---|---|---|
committer | Daniel Elstner <daniel.kitta@gmail.com> | 2009-12-28 04:06:00 +0100 |
commit | a9d41925ad4b206b1d8eeea1e88fe5135fc748a4 (patch) | |
tree | 0f4c56e261ca0371b43fd69f29b0fc3620220143 | |
parent | 3c3bf4c487c1cca7060db6f52f34fb79cb81484d (diff) | |
download | mm-common-a9d41925ad4b206b1d8eeea1e88fe5135fc748a4.tar.gz |
Fine-tune skeleton Doxygen configuration
* docs/reference/Doxyfile.in (EXTRACT_ALL): Disable, so that only
documented classes and functions will appear in the documentation.
(EXTRACT_PRIVATE): Enable. It is perfectly fine to have private
virtual methods, which are of course nonetheless part of the API.
Use the Doxygen @internal command to hide members if necessary.
(SHOW_INCLUDE_FILES): Enable. The displayed filename can be adjusted
with the @headerfile command if required.
(SHOW_USED_FILES): Disable.
(WARN_NO_PARAMDOC): Enable.
(PREDEFINED): Define G_GNUC_INTERNAL to the empty expansion.
(CLASS_DIAGRAMS): Enable. Contrary to what the Doxygen documentation
says, no dot class inheritance graphs will be generated if both
CLASS_DIAGRAMS and COLLABORATION_GRAPH are set to NO.
(COLLABORATION_GRAPH), (GROUP_GRAPHS): Turn off additional graphs to
reduce the noise.
-rw-r--r-- | skeletonmm/doc/reference/Doxyfile.in | 17 |
1 files changed, 9 insertions, 8 deletions
diff --git a/skeletonmm/doc/reference/Doxyfile.in b/skeletonmm/doc/reference/Doxyfile.in index c3d5f07..baa984c 100644 --- a/skeletonmm/doc/reference/Doxyfile.in +++ b/skeletonmm/doc/reference/Doxyfile.in @@ -48,8 +48,8 @@ SYMBOL_CACHE_SIZE = 0 #--------------------------------------------------------------------------- # Build related configuration options #--------------------------------------------------------------------------- -EXTRACT_ALL = YES -EXTRACT_PRIVATE = NO +EXTRACT_ALL = NO +EXTRACT_PRIVATE = YES EXTRACT_STATIC = NO EXTRACT_LOCAL_CLASSES = NO EXTRACT_LOCAL_METHODS = NO @@ -61,7 +61,7 @@ HIDE_IN_BODY_DOCS = YES INTERNAL_DOCS = NO CASE_SENSE_NAMES = YES HIDE_SCOPE_NAMES = NO -SHOW_INCLUDE_FILES = NO +SHOW_INCLUDE_FILES = YES INLINE_INFO = YES SORT_MEMBER_DOCS = YES SORT_BRIEF_DOCS = NO @@ -74,7 +74,7 @@ GENERATE_BUGLIST = NO GENERATE_DEPRECATEDLIST= YES ENABLED_SECTIONS = MAX_INITIALIZER_LINES = 2 -SHOW_USED_FILES = YES +SHOW_USED_FILES = NO SHOW_DIRECTORIES = NO SHOW_FILES = NO SHOW_NAMESPACES = YES @@ -87,7 +87,7 @@ QUIET = NO WARNINGS = YES WARN_IF_UNDOCUMENTED = YES WARN_IF_DOC_ERROR = YES -WARN_NO_PARAMDOC = NO +WARN_NO_PARAMDOC = YES WARN_FORMAT = "$file:$line: $text" WARN_LOGFILE = reference/doxygen.log #--------------------------------------------------------------------------- @@ -234,6 +234,7 @@ INCLUDE_FILE_PATTERNS = *.h PREDEFINED = __cplusplus \ DOXYGEN_SHOULD_SKIP_THIS \ "G_GNUC_CONST=" \ + "G_GNUC_INTERNAL=" \ "SKELETONMM_API=" \ GLIBMM_VFUNCS_ENABLED \ GLIBMM_PROPERTIES_ENABLED \ @@ -254,7 +255,7 @@ PERL_PATH = @PERL@ #--------------------------------------------------------------------------- # Configuration options related to the dot tool #--------------------------------------------------------------------------- -CLASS_DIAGRAMS = NO +CLASS_DIAGRAMS = YES MSCGEN_PATH = HIDE_UNDOC_RELATIONS = NO HAVE_DOT = YES @@ -262,8 +263,8 @@ DOT_FONTNAME = FreeSans DOT_FONTSIZE = 10 DOT_FONTPATH = CLASS_GRAPH = YES -COLLABORATION_GRAPH = YES -GROUP_GRAPHS = YES +COLLABORATION_GRAPH = NO +GROUP_GRAPHS = NO UML_LOOK = NO TEMPLATE_RELATIONS = YES INCLUDE_GRAPH = NO |