[libgpuarray] 16/21: Provide a documentation package

[Ghislain Vaillant]

This is an automated email from the git hooks/post-receive script.

ghisvail-guest pushed a commit to branch master
in repository libgpuarray.

commit 350ed1cec453fd79a705af062fd8faad2b8ab50b
Author: Ghislain Antony Vaillant <ghisvail at gmail.com>
Date:   Mon Jul 17 09:22:08 2017 +0100

    Provide a documentation package
---
 debian/control                  | 30 +++++++++++++++++++++++++++++-
 debian/libgpuarray-doc.doc-base |  9 +++++++++
 debian/libgpuarray-doc.docs     |  1 +
 debian/rules                    | 18 +++++++++++++++---
 4 files changed, 54 insertions(+), 4 deletions(-)

diff --git a/debian/control b/debian/control
index 12c4aa1..9609e59 100644
--- a/debian/control
+++ b/debian/control
@@ -8,6 +8,7 @@ Build-Depends: cmake,
                cython3,
                cython3-dbg,
                debhelper (>= 10),
+               dpkg-dev (>= 1.17.14),
                dh-python,
                libclblas-dev,
                opencl-dev,
@@ -20,7 +21,11 @@ Build-Depends: cmake,
                python3-all-dev,
                python3-numpy,
                python3-numpy-dbg,
-               python3-setuptools
+               python3-setuptools,
+               sphinx-common
+Build-Depends-Indep: python3-breathe <!nodoc>,
+                     python3-sphinx <!nodoc>,
+                     python3-sphinx-rtd-theme <!nodoc>
 Standards-Version: 4.0.0
 Vcs-Browser: https://anonscm.debian.org/cgit/collab-maint/libgpuarray.git
 Vcs-Git: https://anonscm.debian.org/git/collab-maint/libgpuarray.git
@@ -47,6 +52,7 @@ Architecture: any
 Section: libdevel
 Depends: ${misc:Depends},
          libgpuarray2 (= ${binary:Version})
+Suggests: libgpuarray-doc <!nodoc>
 Description: development files for libgpuarray
  libgpuarray provides a ndarray (multi-dimensional array) object which
  is computed on the GPU. It supports int, single and double precision
@@ -59,6 +65,26 @@ Description: development files for libgpuarray
  .
  This package provides the development files.
 
+Package: libgpuarray-doc
+Architecture: all
+Multi-Arch: foreign
+Section: doc
+Depends: ${misc:Depends},
+         ${sphinxdoc:Depends}
+Built-Using: ${sphinxdoc:Built-Using}
+Description: documentation for libgpuarray
+ libgpuarray provides a ndarray (multi-dimensional array) object which
+ is computed on the GPU. It supports int, single and double precision
+ floats.
+ .
+ libgpuarray supports Nvidia's CUDA interface as well as OpenCL. The
+ Debian packages have been build against OpenCL. However, the source
+ package could be rebuild locally also for CUDA (which is non-free)
+ without changes, if that's needed.
+ .
+ This package provides the documentation.
+Build-Profiles: <!nodoc>
+
 Package: python-pygpu
 Architecture: any
 Section: python
@@ -67,6 +93,7 @@ Depends: ${misc:Depends},
          ${shlibs:Depends},
          libgpuarray2 (= ${binary:Version})
 Recommends: python-nose
+Suggests: libgpuarray-doc <!nodoc>
 Description: language bindings for libgpuarray (Python 2)
  libgpuarray provides a ndarray (multi-dimensional array) object which
  is computed on the GPU. It supports int, single and double precision
@@ -108,6 +135,7 @@ Depends: ${misc:Depends},
          ${shlibs:Depends},
          libgpuarray2 (= ${binary:Version})
 Recommends: python3-nose
+Suggests: libgpuarray-doc <!nodoc>
 Description: language bindings for libgpuarray (Python 3)
  libgpuarray provides a ndarray (multi-dimensional array) object which
  is computed on the GPU. It supports int, single and double precision
diff --git a/debian/libgpuarray-doc.doc-base b/debian/libgpuarray-doc.doc-base
new file mode 100644
index 0000000..3c091da
--- /dev/null
+++ b/debian/libgpuarray-doc.doc-base
@@ -0,0 +1,9 @@
+Document: libgpuarray-doc
+Title: libgpuarray Documentation
+Author: Arnaud Bergeron
+Abstract: This is the reference documentation for libgpuarray.
+Section: Programming
+
+Format: HTML
+Index: /usr/share/doc/libgpuarray-doc/html/index.html
+Files: /usr/share/doc/libgpuarray-doc/html/*.html
diff --git a/debian/libgpuarray-doc.docs b/debian/libgpuarray-doc.docs
new file mode 100644
index 0000000..7123782
--- /dev/null
+++ b/debian/libgpuarray-doc.docs
@@ -0,0 +1 @@
+doc/_build/html
diff --git a/debian/rules b/debian/rules
index 2ab1af1..b48c097 100755
--- a/debian/rules
+++ b/debian/rules
@@ -9,20 +9,32 @@ export PYBUILD_AFTER_INSTALL_python2-dbg = rm -f {destdir}/{install_dir}/pygpu/*
 export PYBUILD_AFTER_INSTALL_python3-dbg = rm -f {destdir}/{install_dir}/pygpu/*.h
 
 %:
-	dh $@ --with python2,python3 --buildsystem=pybuild
+	dh $@ --with python2,python3,sphinxdoc --buildsystem=pybuild
 
-override_dh_auto_clean:
+override_dh_auto_clean-arch:
 	dh_auto_clean --buildsystem=cmake
 	dh_auto_clean
 
+override_dh_auto_clean-indep:
+ifeq (,$(findstring nodoc,$(DEB_BUILD_PROFILES)))
+	$(MAKE) -C doc clean
+endif
+
 override_dh_auto_configure:
 	dh_auto_configure --buildsystem=cmake
 	dh_auto_configure
 
-override_dh_auto_build:
+override_dh_auto_build-arch:
 	dh_auto_build --buildsystem=cmake
 	dh_auto_build
 
+override_dh_auto_build-indep: export http_proxy=127.0.0.1:9
+override_dh_auto_build-indep: export https_proxy=127.0.0.1:9
+override_dh_auto_build-indep:
+ifeq (,$(findstring nodoc,$(DEB_BUILD_PROFILES)))
+	PYTHONPATH=$(CURDIR) $(MAKE) -C doc html
+endif
+
 override_dh_auto_test:
 
 override_dh_auto_install:

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/debian-science/packages/libgpuarray.git