[SCM] libdiscid/experimental: Build -doc package

[sramacher at users.alioth.debian.org]

The following commit has been merged in the experimental branch:
commit 27347d5bece0b5f481c8635200aaff49c91a1200
Author: Sebastian Ramacher <sramacher at debian.org>
Date:   Thu Feb 7 15:04:54 2013 +0100

    Build -doc package

diff --git a/debian/changelog b/debian/changelog
index 0fc7f8c..819c363 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -3,7 +3,10 @@ libdiscid (0.3.0-2) UNRELEASED; urgency=low
   * debian/control:
     - Add Vcs* fields.
     - Add libdiscid0-dbg package.
-  * debian/rules: Build debug package.
+    - Add libdiscid-doc package.
+  * debian/rules:
+    - Build -dbg package.
+    - Build documention and -doc package.
 
  -- Sebastian Ramacher <sramacher at debian.org>  Thu, 07 Feb 2013 01:23:04 +0100
 
diff --git a/debian/control b/debian/control
index fb73207..51586af 100644
--- a/debian/control
+++ b/debian/control
@@ -6,6 +6,8 @@ Uploaders: Sebastian Ramacher <sramacher at debian.org>
 Build-Depends:
  debhelper (>= 9),
  dh-autoreconf
+Build-Depends-Indep:
+ doxygen
 Standards-Version: 3.9.4
 Homepage: http://musicbrainz.org/doc/libdiscid
 Vcs-Git: git://anonscm.debian.org/pkg-multimedia/libdiscid.git -b experimental
@@ -14,9 +16,13 @@ Vcs-Browser: http://anonscm.debian.org/gitweb/?p=pkg-multimedia/libdiscid.git
 Package: libdiscid0
 Architecture: any
 Multi-Arch: same
-Pre-Depends: ${misc:Pre-Depends}
-Depends: ${shlibs:Depends}, ${misc:Depends}
-Suggests: libdiscid0-dbg (= ${binary:Version})
+Pre-Depends:
+ ${misc:Pre-Depends}
+Depends:
+ ${misc:Depends},
+ ${shlibs:Depends}
+Suggests:
+ libdiscid0-dbg (= ${binary:Version})
 Description: library for creating MusicBrainz DiscIDs
  libdiscid is a library for creating MusicBrainz DiscIDs from audio CDs.
  It reads a CD's table of contents (TOC) and generates an identifier which
@@ -28,7 +34,11 @@ Package: libdiscid0-dev
 Section: libdevel
 Architecture: any
 Multi-Arch: same
-Depends: ${misc:Depends}, libdiscid0 (= ${binary:Version})
+Depends:
+ ${misc:Depends},
+ libdiscid0 (= ${binary:Version})
+Suggests:
+ libdiscid-doc (= ${source:Version})
 Description: library for creating MusicBrainz DiscIDs (development files)
  libdiscid is a library for creating MusicBrainz DiscIDs from audio CDs.
  It reads a CD's table of contents (TOC) and generates an identifier which
@@ -44,7 +54,9 @@ Priority: extra
 Section: debug
 Architecture: any
 Multi-Arch: same
-Depends: ${misc:Depends}, libdiscid0 (= ${binary:Version})
+Depends:
+ ${misc:Depends},
+ libdiscid0 (= ${binary:Version})
 Description: library for creating MusicBrainz DiscIDs (debugging symbols)
  libdiscid is a library for creating MusicBrainz DiscIDs from audio CDs.
  It reads a CD's table of contents (TOC) and generates an identifier which
@@ -53,3 +65,19 @@ Description: library for creating MusicBrainz DiscIDs (debugging symbols)
  database.
  .
  This package provides the debugging symbols for the shared library.
+
+Package: libdiscid-doc
+Section: doc
+Architecture: all
+Multi-Arch: foreign
+Depends:
+ ${misc:Depends},
+ libjs-jquery
+Description: library for creating MusicBrainz DiscIDs (documentation)
+ libdiscid is a library for creating MusicBrainz DiscIDs from audio CDs.
+ It reads a CD's table of contents (TOC) and generates an identifier which
+ can be used to lookup the CD at MusicBrainz (http://musicbrainz.org).
+ Additionally, it provides a submission URL for adding the DiscID to the
+ database.
+ .
+ This package constains the documentation for libdiscid.
diff --git a/debian/libdiscid-doc.doc-base b/debian/libdiscid-doc.doc-base
new file mode 100644
index 0000000..0f0bf93
--- /dev/null
+++ b/debian/libdiscid-doc.doc-base
@@ -0,0 +1,8 @@
+Document: libdiscid
+Title: libdiscid API documentation
+Abstract: This documentation describes libdiscid's API.
+Section: Programming/C
+
+Format: HTML
+Index: /usr/share/doc/libdiscid-doc/docs/index.html
+Files: /usr/share/doc/libgirara-doc/docs/*.html
diff --git a/debian/libdiscid-doc.docs b/debian/libdiscid-doc.docs
new file mode 100644
index 0000000..77f12ae
--- /dev/null
+++ b/debian/libdiscid-doc.docs
@@ -0,0 +1 @@
+docs/
diff --git a/debian/rules b/debian/rules
index e851182..c1363e1 100755
--- a/debian/rules
+++ b/debian/rules
@@ -3,6 +3,18 @@
 %:
 	dh $@ --with autoreconf
 
-# Build debug package.
+# build documentation if doxygen is available and remove the copy of jquery and
+# replace it with the one from libjs-jquery
+override_dh_auto_build-indep:
+ifneq "$(wildcard /usr/bin/doxygen)" ""
+	doxygen
+	rm -f docs/installdox
+	rm docs/jquery.js
+	ln -s /usr/share/javascript/jquery/jquery.js docs/jquery.js
+endif
+
+# no tests and install for indep
+override_dh_auto_test-indep override_dh_auto_install-indep:
+
 override_dh_strip:
 	dh_strip -plibdiscid0 --dbg-package=libdiscid0-dbg

-- 
libdiscid packaging