From: Jamey Sharp <jamey@minilop.net>
Date: Sun, 19 Nov 2006 00:51:01 +0000 (-0800)
Subject: Turn off Doxygen warnings for undocumented API, for now.
X-Git-Url: http://git.demorecorder.com/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=142fe9a6f2b13d42b0e4baaa25155067f45d065b;p=free-sw%2Fxcb%2Flibxcb

Turn off Doxygen warnings for undocumented API, for now.

But warn about absent parameter documentation for functions that are
otherwise documented.
---

diff --git a/xcb.doxygen b/xcb.doxygen
index ff80d14..1f4bb73 100644
--- a/xcb.doxygen
+++ b/xcb.doxygen
@@ -418,7 +418,8 @@ WARNINGS               = YES
 # for undocumented members. If EXTRACT_ALL is set to YES then this flag will
 # automatically be disabled.
 
-WARN_IF_UNDOCUMENTED   = YES
+# XXX: In the future this should be turned on. For now it generates too much noise.
+WARN_IF_UNDOCUMENTED   = NO
 
 # If WARN_IF_DOC_ERROR is set to YES, doxygen will generate warnings for
 # potential errors in the documentation, such as not documenting some
@@ -433,7 +434,7 @@ WARN_IF_DOC_ERROR      = YES
 # wrong or incomplete parameter documentation, but not about the absence of
 # documentation.
 
-WARN_NO_PARAMDOC       = NO
+WARN_NO_PARAMDOC       = YES
 
 # The WARN_FORMAT tag determines the format of the warning messages that
 # doxygen can produce. The string should contain the $file, $line, and $text