From a4f58d8dec264b1395f6ca09fd59387abe0b81ae Mon Sep 17 00:00:00 2001
From: Thomas Moulard <thomas.moulard@gmail.com>
Date: Mon, 7 Jan 2013 16:26:59 +0900
Subject: [PATCH] Provide documentation package.
---
debian/changelog | 2 +-
debian/control | 15 +++++++++++++++
debian/libvisp-doc.doc-base | 9 +++++++++
debian/libvisp-doc.docs | 1 +
debian/rules | 23 ++++++++++-------------
5 files changed, 36 insertions(+), 14 deletions(-)
create mode 100644 debian/libvisp-doc.doc-base
create mode 100644 debian/libvisp-doc.docs
diff --git a/debian/changelog b/debian/changelog
index 9c09a58e..8bcac22e 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -3,7 +3,7 @@ visp (2.6.2-1) unstable; urgency=low
* Import new upstream version 2.6.2 (Closes: #691252).
* Add patch to rename libvisp-2.so into libvisp.so.
* Add patch to support multiarch (avoid making the assumption that
- $prefix/lib is the library directory but use $libdir instead).
+ $prefix/lib is the library directory but use $libdir instead).
* Add patch that fix typos in source code.
* Provide visp-config man page.
diff --git a/debian/control b/debian/control
index 1c584f7d..d8d85626 100644
--- a/debian/control
+++ b/debian/control
@@ -55,6 +55,7 @@ Depends: libopencv-dev,
libfreenect-dev (>= 0.0.1),
libois-dev,
${misc:Depends}
+Suggests: libvisp-doc
Description: visual servoing library - development files
ViSP, standing for Visual Servoing Platform, is unique. This software
is a complete cross-platform solution that allows prototyping and
@@ -92,3 +93,17 @@ Description: visual servoing library - debugging symbols
computer animation.
.
This package contains the debugging symbols for the shared libraries.
+
+Package: libvisp-doc
+Architecture: all
+Section: doc
+Depends: ${misc:Depends}
+Description: visual servoing library - documentation
+ ViSP, standing for Visual Servoing Platform, is unique. This software
+ is a complete cross-platform solution that allows prototyping and
+ developing applications in visual tracking and visual servoing.
+ .
+ ViSP can be useful in robotics, computer vision, augmented reality and
+ computer animation.
+ .
+ This package contains the Doxygen generated documentation.
diff --git a/debian/libvisp-doc.doc-base b/debian/libvisp-doc.doc-base
new file mode 100644
index 00000000..4d8e2a89
--- /dev/null
+++ b/debian/libvisp-doc.doc-base
@@ -0,0 +1,9 @@
+Document: visp
+Title: ViSP C++ API reference
+Author: INRIA Bretagne, LAGADIC
+Abstract: Describe the ViSP library C++ API.
+Section: Programming/C++
+
+Format: HTML
+Index: /usr/share/doc/libvisp-doc/html/index.html
+Files: /usr/share/doc/libvisp-doc/html/*
diff --git a/debian/libvisp-doc.docs b/debian/libvisp-doc.docs
new file mode 100644
index 00000000..395f4e3f
--- /dev/null
+++ b/debian/libvisp-doc.docs
@@ -0,0 +1 @@
+*/doc/html/
diff --git a/debian/rules b/debian/rules
index a2a13ce2..10333ab7 100755
--- a/debian/rules
+++ b/debian/rules
@@ -1,15 +1,9 @@
#!/usr/bin/make -f
-# -*- makefile -*-
-# Sample debian/rules that uses debhelper.
-# This file was originally written by Joey Hess and Craig Small.
-# As a special exception, when this file is copied by dh-make into a
-# dh-make output file, you may use that output file without restriction.
-# This special exception was added by Craig Small in version 0.37 of dh-make.
-# Uncomment this to turn on verbose mode.
-export DH_VERBOSE=1
-
-.PHONY: override_dh_auto_configure override_dh_strip override_dh_auto_test
+.PHONY: override_dh_auto_configure \
+ override_dh_auto_build \
+ override_dh_strip \
+ override_dh_auto_test
%:
dh $@
@@ -22,17 +16,20 @@ override_dh_auto_clean:
override_dh_auto_configure:
dh_auto_configure -- \
-DBUILD_DEMOS=ON -DBUILD_TESTING=ON -DBUILD_EXAMPLES=ON \
- -DBUILD_SHARED_LIBS=ON -DBUILD_DEPRECATED=ON \
+ -DBUILD_SHARED_LIBS=ON \
-DUSE_DC1394_1=OFF -DUSE_FFMPEG=ON \
-DUSE_DC1394_2=ON -DUSE_V4L2=ON -DUSE_OPENCV=ON \
-DUSE_COIN=ON -DUSE_GSL=OFF \
-DUSE_LAPACK=ON -DUSE_OGRE=ON \
-DUSE_XML2=ON -DUSE_GTK2=ON -DUSE_LIBJPEG=ON \
- -DUSE_LIBPNG=ON -DUSE_LIBPLOTTER=ON \
+ -DUSE_LIBPNG=ON \
-DUSE_LIBFREENECT=ON -DUSE_X11=ON -DUSE_OIS=ON \
- -DDESIRED_QT_VERSION=4 \
-DCMAKE_INSTALL_LIBDIR:STRING="lib/$(DEB_HOST_MULTIARCH)"
+override_dh_auto_build:
+ dh_auto_build -- # Compile the software.
+ dh_auto_build -- html-doc # Generate Doxygen HTML documentation.
+
override_dh_strip:
dh_strip -a --dbg-package=libvisp-dbg
--
GitLab