Add libyaml-doc package for Doxygen-generated API documentation

Signed-off-by: Anders Kaseorg <andersk@mit.edu>

diff --git a/debian/changelog b/debian/changelog
index 607ea5e258d61e80a197b59427ee5cb042d779ae..4f9bc604e10c16a8d3a017bf7f74d901645e268c 100644 (file)
--- a/debian/changelog
+++ b/debian/changelog
@@ -8,6 +8,8 @@ libyaml (0.1.5-1) UNRELEASED; urgency=medium
   * Bump Standards-Version to 3.9.5 (no changes needed).
   * Use dh-autoreconf.
   * Use dh-buildinfo.
+  * Add libyaml-doc package for Doxygen-generated API documentation.
+    (Closes: #696821)
 
  -- Anders Kaseorg <andersk@mit.edu>  Sun, 23 Feb 2014 21:48:49 -0500
 

diff --git a/debian/control b/debian/control
index bf9f305a354b3018d6ca4b829380eaf09d5b6d6a..dcef8e4058d3eea8916d2d7f9c74c70c9c9fab9e 100644 (file)
--- a/debian/control
+++ b/debian/control
@@ -6,7 +6,7 @@ Build-Depends: cdbs (>= 0.4.93~),
  autotools-dev,
  debhelper (>= 9~),
  dh-buildinfo (>= 0.9+nmu1~),
- dh-autoreconf
+ dh-autoreconf, doxygen
 Standards-Version: 3.9.5
 Homepage: http://pyyaml.org/wiki/LibYAML
 Vcs-Git: git://andersk.mit.edu/libyaml.git
@@ -39,8 +39,20 @@ Section: libdevel
 Architecture: any
 Multi-Arch: same
 Depends: ${misc:Depends}, libyaml-0-2 (= ${binary:Version})
+Suggests: libyaml-doc
 Description: Fast YAML 1.1 parser and emitter library (development)
  LibYAML is a C library for parsing and emitting data in YAML 1.1, a
  human-readable data serialization format.
  .
  This package contains development headers and static libraries.
+
+Package: libyaml-doc
+Section: doc
+Architecture: all
+Depends: ${misc:Depends}
+Description: Fast YAML 1.1 parser and emitter library (documentation)
+ LibYAML is a C library for parsing and emitting data in YAML 1.1, a
+ human-readable data serialization format.
+ .
+ This package contains API documentation for developers in HTML
+ format.

diff --git a/debian/control.in b/debian/control.in
index 558fef9eb8238e8d0861d8b52e3ba949a7e71a0f..2b7c408155e694ea067022570da53d9a0c72728d 100644 (file)
--- a/debian/control.in
+++ b/debian/control.in
@@ -2,7 +2,7 @@ Source: libyaml
 Section: libs
 Priority: optional
 Maintainer: Anders Kaseorg <andersk@mit.edu>
-Build-Depends: @cdbs@
+Build-Depends: @cdbs@, doxygen
 Standards-Version: 3.9.5
 Homepage: http://pyyaml.org/wiki/LibYAML
 Vcs-Git: git://andersk.mit.edu/libyaml.git
@@ -35,8 +35,20 @@ Section: libdevel
 Architecture: any
 Multi-Arch: same
 Depends: ${misc:Depends}, libyaml-0-2 (= ${binary:Version})
+Suggests: libyaml-doc
 Description: Fast YAML 1.1 parser and emitter library (development)
  LibYAML is a C library for parsing and emitting data in YAML 1.1, a
  human-readable data serialization format.
  .
  This package contains development headers and static libraries.
+
+Package: libyaml-doc
+Section: doc
+Architecture: all
+Depends: ${misc:Depends}
+Description: Fast YAML 1.1 parser and emitter library (documentation)
+ LibYAML is a C library for parsing and emitting data in YAML 1.1, a
+ human-readable data serialization format.
+ .
+ This package contains API documentation for developers in HTML
+ format.

diff --git a/debian/libyaml-doc.doc-base b/debian/libyaml-doc.doc-base
new file mode 100644 (file)
index 0000000..c841500
--- /dev/null
+++ b/debian/libyaml-doc.doc-base
@@ -0,0 +1,9 @@
+Document: libyaml
+Title: LibYAML API documentation
+Author: Kirill Simonov <xi@resolvent.net>
+Abstract: Doxygen-generated API documentation for LibYAML.
+Section: Programming/C
+
+Format: HTML
+Index: /usr/share/doc/libyaml-doc/html/index.html
+Files: /usr/share/doc/libyaml-doc/html/*.html

diff --git a/debian/libyaml-doc.docs b/debian/libyaml-doc.docs
new file mode 100644 (file)
index 0000000..a651601
--- /dev/null
+++ b/debian/libyaml-doc.docs
@@ -0,0 +1 @@
+doc/html/

diff --git a/debian/rules b/debian/rules
index eddf3ded7c022321eaede0e626ca8b423fe63d1e..bf41f8be6a8c7ae4604903eaef73c419ac39ef52 100755 (executable)
--- a/debian/rules
+++ b/debian/rules
@@ -9,6 +9,9 @@ CDBS_BUILD_DEPENDS += , cdbs (>= 0.4.93~)  # for $(DEB_HOST_MULTIARCH)
 # dh_buildinfo < 0.9+nmu1 fails at multiarch: http://bugs.debian.org/620104
 CDBS_BUILD_DEPENDS_rules_debhelper_buildinfo = dh-buildinfo (>= 0.9+nmu1~)
 
+build/libyaml-doc::
+       $(MAKE) html
+
 DEB_CONFIGURE_EXTRA_FLAGS += --libdir=\$${prefix}/lib/$(DEB_HOST_MULTIARCH)
 DEB_MAKE_CHECK_TARGET = check
 DEB_DH_INSTALL_SOURCEDIR = $(DEB_DESTDIR)