[pdal] 07/08: Build documentation with sphinx.

[Sebastiaan Couwenberg]

This is an automated email from the git hooks/post-receive script.

sebastic pushed a commit to branch master
in repository pdal.

commit cd35b4c4ea5c597bddf9f74ea086a6500391e9da
Author: Bas Couwenberg <sebastic at xs4all.nl>
Date:   Sun Mar 20 01:51:45 2016 +0100

    Build documentation with sphinx.
---
 debian/control           | 29 +++++++++++++++++++++++++++++
 debian/pdal-doc.doc-base | 10 ++++++++++
 debian/pdal-doc.install  |  1 +
 debian/rules             |  6 +++++-
 4 files changed, 45 insertions(+), 1 deletion(-)

diff --git a/debian/control b/debian/control
index 1a0655e..d7fb349 100644
--- a/debian/control
+++ b/debian/control
@@ -27,7 +27,11 @@ Build-Depends: debhelper (>= 9),
                libxml2-dev,
                pkg-kde-tools,
                python-all-dev,
+               python-breathe,
                python-numpy,
+               python-sphinx,
+               python-sphinx-bootstrap-theme,
+               rst2pdf,
                zlib1g-dev,
                docbook2x,
                docbook-xsl,
@@ -43,6 +47,7 @@ Architecture: any
 Section: utils
 Depends: ${shlibs:Depends},
          ${misc:Depends}
+Suggests: pdal-doc
 Description: Point Data Abstraction Library
  PDAL is a BSD licensed library for translating and manipulating point
  cloud data of various formats. PDAL can be used to read, write and
@@ -59,6 +64,29 @@ Description: Point Data Abstraction Library
  .
  This package contains the PDAL utilities.
 
+Package: pdal-doc
+Architecture: all
+Section: doc
+Depends: ${sphinxdoc:Depends},
+         ${misc:Depends}
+Suggests: libdal-dev,
+          pdal
+Description: Point Data Abstraction Library - documentation
+ PDAL is a BSD licensed library for translating and manipulating point
+ cloud data of various formats. PDAL can be used to read, write and
+ translate point cloud data in many formats. Support is included for
+ input files of LAS, LAZ, SBET, BPF, QFIT and others. PDAL can also read
+ from and write to databases that support point cloud storage, including
+ Oracle, Postgres and SQLite.
+ .
+ PDAL should not be confused with PCL (Point Cloud Library). PCL is a
+ library specifically designed to provide algorithmic analysis and
+ modification of point clouds. PDAL provides a limited interface to the
+ facilities of PCL, but does not in general attempt to duplicate its
+ capabilities.
+ .
+ This package contains the PDAL documentation.
+
 Package: libpdal-base1
 Architecture: any
 Section: libs
@@ -139,6 +167,7 @@ Depends: libpdal-base1 (= ${binary:Version}),
          libproj-dev,
          libxml2-dev,
          ${misc:Depends}
+Suggests: pdal-doc
 Description: Point Data Abstraction Library - development files
  PDAL is a BSD licensed library for translating and manipulating point
  cloud data of various formats. PDAL can be used to read, write and
diff --git a/debian/pdal-doc.doc-base b/debian/pdal-doc.doc-base
new file mode 100644
index 0000000..bdbe4d8
--- /dev/null
+++ b/debian/pdal-doc.doc-base
@@ -0,0 +1,10 @@
+Document: pdal
+Title: PDAL Documentation
+Author: Hobu, Inc. <howard at hobu.co>
+Abstract: This manual describes what PDAL is
+ and how it can be used.
+Section: Science/Geoscience
+
+Format: HTML
+Index: /usr/share/doc/pdal/html/index.html
+Files: /usr/share/doc/pdal/html/*.html
diff --git a/debian/pdal-doc.install b/debian/pdal-doc.install
new file mode 100644
index 0000000..8c06c01
--- /dev/null
+++ b/debian/pdal-doc.install
@@ -0,0 +1 @@
+doc/html usr/share/doc/pdal/
diff --git a/debian/rules b/debian/rules
index 1f551f6..13a3e19 100755
--- a/debian/rules
+++ b/debian/rules
@@ -13,7 +13,7 @@ BUILD_DATE       = $(shell dpkg-parsechangelog | sed -ne 's/^Date: //p' | LC_ALL
 MANPAGES := $(wildcard debian/man/*.*.xml)
 
 %:
-	dh $@ --with pkgkde_symbolshelper --parallel
+	dh $@ --with pkgkde_symbolshelper,sphinxdoc --parallel
 
 override_dh_clean:
 	if [ -e debian/gtest.config.guess ]; then \
@@ -25,6 +25,8 @@ override_dh_clean:
 
 	dh_clean debian/man/*.1
 
+	$(RM) -r doc/html
+
 override_dh_auto_configure:
 	# Don't use outdated autotools helper files
 	mv `ls -d vendor/gtest-*`/build-aux/config.guess debian/gtest.config.guess
@@ -50,6 +52,8 @@ override_dh_auto_build:
 
 	dh_auto_build
 
+	sphinx-build doc/ doc/html/
+
 override_dh_auto_test:
 	# Exclude tests:
 	# - pgpointcloudtest, requires configured PostgreSQL database

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-grass/pdal.git