As explained in this bug, the attached patch does what's expected (of course, one need to add "doxygen source3/Doxyfile" to debian/rules).
Steve proposed shipping this documentation in a separate package, which I'm fine about... Any proposal for the new package name? --
Index: samba/source3/Doxyfile
===================================================================
--- samba.orig/source3/Doxyfile
+++ samba/source3/Doxyfile
@@ -66,9 +66,7 @@
#---------------------------------------------------------------------------
INPUT = .
INPUT_ENCODING = UTF-8
-FILE_PATTERNS = *.c \
- *.h \
- *.idl
+FILE_PATTERNS = libsmbclient.h
RECURSIVE = YES
EXCLUDE = include/includes.h \
include/proto.h
@@ -83,13 +81,13 @@
#---------------------------------------------------------------------------
# configuration options related to source browsing
#---------------------------------------------------------------------------
-SOURCE_BROWSER = YES
+SOURCE_BROWSER = NO
INLINE_SOURCES = YES
STRIP_CODE_COMMENTS = NO
REFERENCED_BY_RELATION = YES
REFERENCES_RELATION = YES
REFERENCES_LINK_SOURCE = YES
-VERBATIM_HEADERS = YES
+VERBATIM_HEADERS = NO
#---------------------------------------------------------------------------
# configuration options related to the alphabetical class index
#---------------------------------------------------------------------------
signature.asc
Description: Digital signature
