[Pkg-samba-maint] Bug#406480: libsmbclient-dev: Should ship doxygen-generated documentation

[Samuel Thibault]

Package: libsmbclient-dev
Version: 3.0.23d-2+b1
Severity: wishlist
Tags: patch

Hi,

It would be useful to see libsmbclient-dev ship the Doxygen
documentation of libsmbclient. It can be generated by just running
doxygen source/Doxyfile. The attached patch restricts the documentation
to only libsmbclient (internal interfaces and source code don't matter
to user).

Samuel

-- System Information:
Debian Release: 4.0
  APT prefers testing
  APT policy: (990, 'testing'), (500, 'unstable'), (500, 'stable'), (1, 'experimental')
Architecture: i386 (i686)
Shell:  /bin/sh linked to /bin/bash
Kernel: Linux 2.6.19
Locale: LANG=fr_FR at euro, LC_CTYPE=fr_FR at euro (charmap=ISO-8859-15)

Versions of packages libsmbclient-dev depends on:
ii  libsmbclient                3.0.23d-2+b1 shared library that allows applica

libsmbclient-dev recommends no packages.

-- no debconf information

-- 
Samuel Thibault <samuel.thibault at ens-lyon.org>
<L> pour moi le seul qui est autorisé à fasciser, c moi :-)
-------------- next part --------------
--- samba-3.0.23d/source/Doxyfile	2005-02-25 18:59:25.000000000 +0100
+++ samba-3.0.23d-mine/source/Doxyfile	2007-01-11 14:40:06.000000000 +0100
@@ -27,13 +27,13 @@
 STRIP_FROM_PATH        = $(PWD)/
 INTERNAL_DOCS          = YES
 CLASS_DIAGRAMS         = YES
-SOURCE_BROWSER         = YES
+SOURCE_BROWSER         = NO
 INLINE_SOURCES         = YES
 STRIP_CODE_COMMENTS    = NO
 CASE_SENSE_NAMES       = YES
 SHORT_NAMES            = NO
 HIDE_SCOPE_NAMES       = YES
-VERBATIM_HEADERS       = YES
+VERBATIM_HEADERS       = NO
 SHOW_INCLUDE_FILES     = YES
 JAVADOC_AUTOBRIEF      = YES
 INHERIT_DOCS           = YES
@@ -62,9 +62,7 @@
 # configuration options related to the input files
 #---------------------------------------------------------------------------
 INPUT                  = . 
-FILE_PATTERNS          = *.c \
-                         *.h \
-                         *.idl
+FILE_PATTERNS          = libsmbclient.h 
 RECURSIVE              = YES
 EXCLUDE                = include/includes.h \
                          include/proto.h