Now building the doc in a heat-doc package.

debian/changelog

@@ -2,6 +2,7 @@ heat (2014.1~b2-1) experimental; urgency=low
 
   * New upstream release (Icehouse beta 1).
   * Added new (build)-depends python-heatclient (>= 0.2.3).
+  * Now building the sphinx doc in a heat-doc package.
 
  -- Thomas Goirand <zigo@debian.org>  Mon, 09 Dec 2013 22:01:07 +0800
 

debian/control

@@ -191,3 +191,15 @@ Description: OpenStack orchestration service - CloudWatch API
  CloudFormation-compatible Query API.
  .
  This package contains the CloudWatch API.
+
+Package: heat-doc
+Architecture: all
+Section: doc
+Pre-Depends: dpkg (>= 1.15.6~)
+Depends: ${misc:Depends}, ${sphinxdoc:Depends}
+Description: OpenStack orchestration service - Documentation
+ Heat is a service to orchestrate multiple composite cloud applications using
+ templates, through both an OpenStack-native ReST API and a
+ CloudFormation-compatible Query API.
+ .
+ This package contains the documentation.

debian/heat-doc.doc-base

@@ -0,0 +1,9 @@
+Document: heat-doc
+Title: Heat Documentation
+Author: OpenStack
+Abstract: Sphinx documentation for Heat
+Section: Network/File Transfer
+
+Format: HTML
+Index: /usr/share/doc/heat-doc/html/index.html
+Files: /usr/share/doc/heat-doc/html/*

debian/rules

@@ -4,7 +4,7 @@ include /usr/share/openstack-pkg-tools/pkgos.make
 export OSLO_PACKAGE_VERSION=$(VERSION)
 
 %:
-	dh $@  --with python2
+	dh $@ --buildsystem=python_distutils --with python2,sphinxdoc
 
 ifeq (,$(findstring nocheck, $(DEB_BUILD_OPTIONS)))
 override_dh_auto_test:
@@ -32,6 +32,13 @@ override_dh_auto_build:
 	/usr/share/openstack-pkg-tools/pkgos_insert_include pkgos_func heat-common.config
 
 override_dh_installman:
-	python setup.py build
-	make -C doc man
+ifeq (,$(findstring nodocs, $(DEB_BUILD_OPTIONS)))
+	sphinx-build -b man doc/source doc/build/man
 	dh_installman
+endif
+
+override_dh_sphinxdoc:
+ifeq (,$(findstring nodocs, $(DEB_BUILD_OPTIONS)))
+	sphinx-build -b html doc/source $(CURDIR)/debian/heat-doc/usr/share/doc/heat-doc/html
+	dh_sphinxdoc -O--buildsystem=python_distutils
+endif