[SCM] pysoundfile/master: Build documentation

[umlaeute at users.alioth.debian.org]

The following commit has been merged in the master branch:
commit 396092bce72999cbdd04f18835fd54bab97d0c28
Author: IOhannes m zmölnig <zmoelnig at umlautS.umlaeute.mur.at>
Date:   Thu Nov 23 12:51:40 2017 +0100

    Build documentation

diff --git a/debian/control b/debian/control
index d9e687f..882336e 100644
--- a/debian/control
+++ b/debian/control
@@ -15,6 +15,7 @@ Build-Depends:
  python3-cffi,
  python3-pytest,
  python3-numpy,
+ python3-sphinx, python3-sphinx-rtd-theme,
 Standards-Version: 4.1.1
 Homepage: https://github.com/bastibe/PySoundFile
 Vcs-Git: https://anonscm.debian.org/git/pkg-multimedia/pysoundfile.git
@@ -39,10 +40,26 @@ Description: Python 3 audio module based on libsndfile
  By default, PySoundFile represents audio data as NumPy arrays, but ordinary
  Python buffers are supported as well.
  .
- Full documentation is available on http://pysoundfile.readthedocs.org/.
- .
  This package provides the Python 3.x module.
 
+Package: python-soundfile-doc
+Section: doc
+Architecture: all
+Depends:
+ ${misc:Depends},
+ ${sphinxdoc:Depends},
+ libjs-mathjax,
+Built-Using:
+ ${sphinxdoc:Built-Using},
+Description: Python audio module based on libsndfile - documentation
+ PySoundFile can read and write sound files in a variety of formats and eases
+ the application of signal processing algorithms.
+ File reading/writing is supported through libsndfile.
+ By default, PySoundFile represents audio data as NumPy arrays, but ordinary
+ Python buffers are supported as well.
+ .
+ This package provides the API documentation.
+
 Package: python-soundfile
 Architecture: all
 Depends:
@@ -62,6 +79,4 @@ Description: Python audio module based on libsndfile and NumPy
  By default, PySoundFile represents audio data as NumPy arrays, but ordinary
  Python buffers are supported as well.
  .
- Full documentation is available on http://pysoundfile.readthedocs.org/.
- .
  This package provides the Python 2.x module.
diff --git a/debian/rules b/debian/rules
index 2ccaa21..5c1972b 100755
--- a/debian/rules
+++ b/debian/rules
@@ -2,11 +2,16 @@
 export PYBUILD_NAME=soundfile
 
 %:
-	dh $@ --buildsystem=pybuild --with python2,python3
+	dh $@ --buildsystem=pybuild --with python2,python3,sphinxdoc
+
+override_dh_auto_build:
+	dh_auto_build
+	make -C doc html
 
 override_dh_clean:
 	dh_clean
-	rm -rf SoundFile.egg-info/
+	rm -f _soundfile.py
+	rm -rf SoundFile.egg-info/ doc/_build/
 
 licensecheck:
 	licensecheck --deb-machine -r * > debian/copyright_newhints

-- 
pysoundfile packaging