[h5py] 04/07: d/*: add documentation package

[Ghislain Vaillant]

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

ghisvail-guest pushed a commit to branch debian/experimental
in repository h5py.

commit d8f8e1a0aa4d2e3884686b29e5fb0707804215ae
Author: Ghislain Antony Vaillant <ghisvail at gmail.com>
Date:   Fri Apr 17 10:29:11 2015 +0100

    d/*: add documentation package
---
 debian/control              | 29 ++++++++++++++++++++++++++++-
 debian/python-h5py-doc.docs |  1 +
 debian/rules                |  6 +++++-
 3 files changed, 34 insertions(+), 2 deletions(-)

diff --git a/debian/control b/debian/control
index 44f1cc1..77217f0 100644
--- a/debian/control
+++ b/debian/control
@@ -15,7 +15,8 @@ Build-Depends: debhelper (>= 9),
                python3-numpy (>= 1:1.7.1-1~),
                cython (>= 0.17-1~),
                cython3 (>= 0.17-1~),
-               pkg-config
+               pkg-config,
+               python-sphinx (>= 1.0.7+dfsg-1~) 
 Standards-Version: 3.9.6
 Vcs-Browser: https://anonscm.debian.org/cgit/debian-science/packages/h5py.git
 Vcs-Git: git://anonscm.debian.org/debian-science/packages/h5py.git
@@ -74,3 +75,29 @@ Description: General-purpose Python interface to hdf5 (Python 3)
  presented using a dictionary metaphor, indexed by name.
  .
  This package provides the Python 3 version of h5py.
+
+Package: python-h5py-doc
+Architecture: all
+Section: doc
+Depends: ${sphinxdoc:Depends},
+         ${misc:Depends}
+Description: General-purpose Python interface to hdf5 (documentation)
+ HDF5 for Python (h5py) is a general-purpose Python interface to the
+ Hierarchical Data Format library, version 5. HDF5 is a versatile, mature
+ scientific software library designed for the fast, flexible storage of
+ enormous amounts of data. 
+ .
+ From a Python programmer's perspective, HDF5 provides a robust way to
+ store data, organized by name in a tree-like fashion. You can create
+ datasets (arrays on disk) hundreds of gigabytes in size, and perform
+ random-access I/O on desired sections. Datasets are organized in a
+ filesystem-like hierarchy using containers called "groups", and accessed
+ using the tradional POSIX /path/to/resource syntax. 
+ .
+ H5py provides a simple, robust read/write interface to HDF5 data from
+ Python. Existing Python and Numpy concepts are used for the interface;
+ for example, datasets on disk are represented by a proxy class that
+ supports slicing, and has dtype and shape attributes. HDF5 groups are
+ presented using a dictionary metaphor, indexed by name.
+ .
+ This package provides the documentation for h5py.
diff --git a/debian/python-h5py-doc.docs b/debian/python-h5py-doc.docs
new file mode 100644
index 0000000..6d28621
--- /dev/null
+++ b/debian/python-h5py-doc.docs
@@ -0,0 +1 @@
+build/html
diff --git a/debian/rules b/debian/rules
index c79790b..ebf0e59 100755
--- a/debian/rules
+++ b/debian/rules
@@ -11,7 +11,11 @@ export CFLAGS=$(shell pkg-config --cflags hdf5)
 export LDFLAGS=$(shell pkg-config --libs hdf5)
 
 %:
-	dh $@ --with python2,python3 --buildsystem=pybuild
+	dh $@ --with python2,python3,sphinxdoc --buildsystem=pybuild
+
+override_dh_auto_build:
+    dh_auto_build
+    PYTHONPATH=. http_proxy='127.0.0.1:9' sphinx-build -N -bhtml docs/ build/html
 
 override_dh_auto_clean:
 	dh_auto_clean

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