[SCM] Core functionality for performing astronomy and astrophysics with Python branch, debian, updated. c8988b8ecccef071edbbc11a7817bc05c5cf7faa

[Ole Streicher]

The following commit has been merged in the debian branch:
commit c8988b8ecccef071edbbc11a7817bc05c5cf7faa
Author: Ole Streicher <debian at liska.ath.cx>
Date:   Thu Jul 12 12:09:55 2012 +0200

    Add a "docs" package

diff --git a/debian/control b/debian/control
index 3749968..a56bec4 100644
--- a/debian/control
+++ b/debian/control
@@ -10,6 +10,7 @@ Build-Depends: debhelper (>= 9),
                python-nose,
                python-numpy,
                python-setuptools,
+	       python-sphinx (>= 1.0.7+dfsg),
                python-support,
                wcslib-dev (>= 4.7),
                zlib1g-dev
@@ -18,6 +19,18 @@ Homepage: http://astropy.org
 Vcs-Git: git://git.debian.org/git/debian-science/packages/python-astropy.git
 Vcs-Browser: http://git.debian.org/?p=debian-science/packages/python-astropy.git
 
+Package: python-astropy-docs
+Architecture: all
+Section: doc
+Depends: ${sphinxdoc:Depends}, ${misc:Depends}
+Description: Core functionality for performing astrophysics with Python (doc)
+ The astropy package contains core functionality and some common tools 
+ needed for performing astronomy and astrophysics research with Python. 
+ It is expected to be extended by a number of "affilated packages" that are
+ intended to work with the core package.
+ .
+ This package contains the package documentation.
+
 Package: python-astropy
 Architecture: any
 Depends: libexpat1,
@@ -27,6 +40,7 @@ Depends: libexpat1,
          ${python:Depends},
          ${shlibs:Depends}
 Provides: ${python:Provides}
+Suggests: python-astropy-docs
 Description: Core functionality for performing astrophysics with Python
  The astropy package contains core functionality and some common tools 
  needed for performing astronomy and astrophysics research with Python. 
diff --git a/debian/python-astropy-docs.doc-base b/debian/python-astropy-docs.doc-base
new file mode 100644
index 0000000..dce6af7
--- /dev/null
+++ b/debian/python-astropy-docs.doc-base
@@ -0,0 +1,11 @@
+Document: python-astropy
+Title: Astropy Documentation
+Author: The Astropy Collaboration.
+Section: Science/Astronomy
+Abstract: Astropy is a community-driven package intended to contain much of
+ the core functionality and some common tools needed for performing astronomy
+ and astrophysics with Python. 
+
+Format: HTML
+Index: /usr/share/doc/python-astropy-docs/html/index.html
+Files: /usr/share/doc/python-astropy-docs/html/
diff --git a/debian/python-astropy-docs.lintian-overrides b/debian/python-astropy-docs.lintian-overrides
new file mode 100644
index 0000000..f419796
--- /dev/null
+++ b/debian/python-astropy-docs.lintian-overrides
@@ -0,0 +1,5 @@
+# We store an extra license file since this is linked within the 
+# HTML documentation. It seems to be better to keep this file than
+# to remove these links or to link to the machine-readable Debian 
+# copyright file.
+extra-license-file usr/share/doc/python-astropy-docs/html/_sources/creditsandlicense.txt
diff --git a/debian/rules b/debian/rules
index c4dd882..f94f964 100755
--- a/debian/rules
+++ b/debian/rules
@@ -1,12 +1,18 @@
 #!/usr/bin/make -f
 
 %:
-	dh $@ --with python2
+	dh $@ --with python2,sphinxdoc
 
 override_dh_shlibdeps:
 	dh_shlibdeps
 	dh_numpy
 
-override_dh_clean:
-	dh_clean
+override_dh_installdocs:
+	python setup.py build_sphinx
+	dh_installdocs docs/_build/html
+
+override_dh_auto_clean:
+	dh_auto_clean
 	rm -rf build astropy.egg-info
+	rm -rf build docs/_build
+

-- 
Core functionality for performing astronomy and astrophysics with Python