major documentation rework and packaging

debian/control

@@ -2,7 +2,7 @@ Source: python3-damaris
 Section: science
 Priority: optional
 Maintainer: Markus Rosenstihl <markus.rosenstihl@pkm.tu-darmstadt.de>
-Build-Depends: python3, debhelper, python3-dev, dh-sequence-python3, dpkg-dev, pybuild-plugin-pyproject
+Build-Depends: python3, debhelper, python3-dev, dh-sequence-python3, dpkg-dev, pybuild-plugin-pyproject, sphinx-common, sphinx-rtd-theme-common
 Standards-Version: 3.7.3
 X-Python3-Version: >= 3.5
 Rules-Requires-Root: no

debian/copyright

@@ -0,0 +1,13 @@
+Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
+Upstream-Name: python3-damaris
+Upstream-Contact: Markus Rosenstihl <markus.rosenstihl@pkm.tu-darmstadt.de>
+Source: https://gitea.pkm.physik.tu-darmstadt.de/IPKM/python3-damaris
+
+Files: *
+Copyright: © 2007-2026, Achim Gaedke, Markus Rosenstihl, and others
+License: GPL-2.0
+
+Files: debian/*
+Copyright: © 2007-2026, Achim Gaedke, Markus Rosenstihl, and others
+License: GPL-2.0
+Comment: Debian packaging is under the same license as upstream

debian/install

@@ -0,0 +1 @@
+doc/ usr/share/doc/python3-damaris/

debian/rules

@@ -13,7 +13,12 @@ PYBASE=$(CURDIR)/debian/${PACKAGE_NAME}
 DH_ALWAYS_EXCLUDE=CVS:.git:venv:.venv:*.h5
 
 %:
-	dh $@ --buildsystem=pybuild
+	dh $@ --buildsystem=pybuild --with sphinxdoc
+
+override_dh_auto_build:
+	dh_auto_build
+	sphinx-build -N -bhtml doc/ build/doc
+
 
 override_dh_auto_test:
 	PYBUILD_TEST_ARGS="-v $(CURDIR)/tests" dh_auto_test