Generic docs need reST

Conversion of all docs to reST so that the generic docs can link easily
with the rest of the docs.

debian/control

@@ -3,7 +3,7 @@ Maintainer: Ben Nuttall <ben@raspberrypi.org>
 Homepage: http://github.com/RPi-Distro/python-gpiozero
 Section: python
 Priority: extra
-Build-Depends: debhelper (>= 8), python-all (>= 2.7), python-setuptools, python3-all, python3-setuptools
+Build-Depends: debhelper (>= 8), python-all (>= 2.7), python-setuptools, python3-all, python3-setuptools, python-sphinx (>= 1.0.7+dfsg-1~)
 Standards-Version: 3.9.6
 X-Python-Version: >= 2.7
 X-Python3-Version: >= 3.2
@@ -32,3 +32,14 @@ Description: Simple API for controlling devices attached to the GPIO pins.
  .
  This is the Python 3 version of the package.
 
+Package: python-gpiozero-doc
+Architecture: all
+Section: doc
+Depends: ${sphinxdoc:Depends}, ${misc:Depends}
+Description: Documentation for the gpiozero API
+ gpiozero builds on RPi.GPIO to provide a set of classes designed to simplify
+ interaction with devices connected to the GPIO pins, from simple buttons and
+ LEDs, up to various add-on boards. The API tries to adhere closely to Python's
+ idioms and naming conventions.
+ .
+ This is the version independent documentation for the package.

debian/python-gpiozero-doc.doc-base

@@ -0,0 +1,10 @@
+Document: python-gpiozero
+Title: GPIO Zero Reference
+Author: Ben Nuttall <ben@raspberrypi.org>
+Abstract: Documentation for the gpiozero API
+Section: Programming/Python
+
+Format: HTML
+Index: /usr/share/doc/python-gpiozero-doc/html/index.html
+Files: /usr/share/doc/python-gpiozero-doc/html/*
+

debian/python-gpiozero-doc.docs

@@ -0,0 +1 @@
+build/sphinx/html/

debian/rules

@@ -5,7 +5,7 @@
 export DH_OPTIONS
 
 %:
-	dh $@ --with python2,python3 --buildsystem=python_distutils
+	dh $@ --with python2,python3,sphinxdoc --buildsystem=python_distutils
 
 override_dh_auto_install:
 	python setup.py install --root debian/python-gpiozero --install-layout=deb
@@ -14,7 +14,7 @@ override_dh_auto_install:
 #override_dh_auto_test:
 #	# Don't run the tests!
 
-#override_dh_installdocs:
-#	python setup.py build_sphinx -b html
-#	dh_installdocs
+override_dh_installdocs:
+	python setup.py build_sphinx -b html
+	dh_installdocs