[python-xarray] 08/12: Add the 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 python-xarray.

commit 98d4f56fd8ba9d5adb5c33adadf17166aedc8afd
Author: Ghislain Antony Vaillant <ghisvail at gmail.com>
Date:   Sat Apr 15 15:23:16 2017 +0100

    Add the documentation package
    
    - Add cartopy, ipython, numpydoc, sphinx, sphinx-rtd-theme to the list
      of b-deps
    - Mark the dask, matplotlib, netcdf4, numpy, pandas, scipy, seaborn
      b-deps as !nodoc
    - Do not build the documentation if the nodoc b-prof is requested
    
    Gbp-Dch: full
---
 debian/control                    | 43 +++++++++++++++++++++++++++++++--------
 debian/python-xarray-doc.doc-base |  9 ++++++++
 debian/python-xarray-doc.docs     |  1 +
 debian/rules                      | 16 ++++++++++++++-
 4 files changed, 59 insertions(+), 10 deletions(-)

diff --git a/debian/control b/debian/control
index 1c0d34c..5d5cc32 100644
--- a/debian/control
+++ b/debian/control
@@ -8,20 +8,26 @@ Build-Depends: debhelper (>= 10),
                dpkg-dev (>= 1.17.14),
                python3-all,
                python3-bottleneck <!nocheck>,
-               python3-dask <!nocheck>,
+               python3-cartopy <!nodoc>,
+               python3-dask <!nocheck> <!nodoc>,
 #               python3-distributed <!nocheck>,
                python3-h5netcdf <!nocheck>,
                python3-h5py <!nocheck>,
-               python3-matplotlib <!nocheck>,
-               python3-netcdf4 <!nocheck>,
-               python3-numpy <!nocheck>,
-               python3-pandas (>= 0.15.0) <!nocheck>,
+               python3-ipython <!nodoc>,
+               python3-matplotlib <!nocheck> <!nodoc>,
+               python3-netcdf4 <!nocheck> <!nodoc>,
+               python3-numpy <!nocheck> <!nodoc>,
+               python3-numpydoc <!nodoc>,
+               python3-pandas (>= 0.15.0) <!nocheck> <!nodoc>,
 #               python3-pydap <!nocheck>,
                python3-pytest (>= 2.7.1) <!nocheck>,
                python3-setuptools,
-               python3-scipy <!nocheck>,
-               python3-seaborn <!nocheck>,
-               python3-toolz <!nocheck>
+               python3-scipy <!nocheck> <!nodoc>,
+               python3-seaborn <!nocheck> <!nodoc>,
+               python3-sphinx <!nodoc>,
+               python3-sphinx-rtd-theme <!nodoc>,
+               python3-toolz <!nocheck>,
+               sphinx-common
 Standards-Version: 3.9.8
 Vcs-Browser: https://anonscm.debian.org/git/debian-science/packages/python-xarray.git
 Vcs-Git: https://anonscm.debian.org/git/debian-science/packages/python-xarray.git
@@ -32,7 +38,8 @@ Package: python3-xarray
 Architecture: all
 Depends: ${misc:Depends},
          ${python3:Depends}
-Suggests: python3-bottleneck,
+Suggests: python-xarray-doc <!nodoc>,
+          python3-bottleneck,
           python3-dask,
           python3-distributed,
           python3-h5netcdf,
@@ -53,3 +60,21 @@ Description: N-D labeled arrays and datasets in Python 3
  excels.
  .
  This package provides the Python 3 library
+
+Package: python-xarray-doc
+Architecture: all
+Section: doc
+Depends: ${misc:Depends},
+         ${sphinxdoc:Depends}
+Built-Using: ${sphinxdoc:Built-Using}
+Description: documentation for xarray
+ xarray (formerly xray) is an open source project and Python package that aims
+ to bring the labeled data power of pandas to the physical sciences, by
+ providing N-dimensional variants of the core pandas data structures.
+ .
+ It provides a pandas-like and pandas-compatible toolkit for analytics on
+ multi-dimensional arrays, rather than the tabular data for which pandas
+ excels.
+ .
+ This package provides the documentation.
+Build-Profiles: <!nodoc>
diff --git a/debian/python-xarray-doc.doc-base b/debian/python-xarray-doc.doc-base
new file mode 100644
index 0000000..b1bca19
--- /dev/null
+++ b/debian/python-xarray-doc.doc-base
@@ -0,0 +1,9 @@
+Document: python-xarray-doc
+Title: xarray Documentation
+Author: xarray Developers
+Abstract: This is the reference documentation for xarray.
+Section: Programming/Python
+
+Format: HTML
+Index: /usr/share/doc/python-xarray-doc/html/index.html
+Files: /usr/share/doc/python-xarray-doc/html/*.html
diff --git a/debian/python-xarray-doc.docs b/debian/python-xarray-doc.docs
new file mode 100644
index 0000000..7123782
--- /dev/null
+++ b/debian/python-xarray-doc.docs
@@ -0,0 +1 @@
+doc/_build/html
diff --git a/debian/rules b/debian/rules
index 25d797a..226b0d7 100755
--- a/debian/rules
+++ b/debian/rules
@@ -9,4 +9,18 @@ export PYBUILD_DISABLE = test
 endif
 
 %:
-	dh $@ --with python3 --buildsystem=pybuild
+	dh $@ --with python3,sphinxdoc --buildsystem=pybuild
+
+override_dh_auto_clean:
+	dh_auto_clean
+ifeq (,$(findstring nodoc,$(DEB_BUILD_PROFILES)))
+	$(MAKE) -C doc clean
+endif
+
+override_dh_auto_build: export http_proxy=127.0.0.1:9
+override_dh_auto_build: export https_proxy=127.0.0.1:9
+override_dh_auto_build:
+	dh_auto_build
+ifeq (,$(findstring nodoc,$(DEB_BUILD_PROFILES)))
+	PYTHONPATH=$(CURDIR) $(MAKE) -C doc html
+endif

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