[laszip] 03/03: Add manpage for laszippertest.

[Bas Couwenberg]

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

sebastic-guest pushed a commit to branch master
in repository laszip.

commit ae6ccb54b620f71ef008abd58848cb64e13278bf
Author: Bas Couwenberg <sebastic at xs4all.nl>
Date:   Fri Jun 6 13:18:57 2014 +0200

    Add manpage for laszippertest.
---
 debian/control                 |  6 ++-
 debian/laszip-bin.manpages     |  1 +
 debian/man/laszippertest.1.xml | 89 ++++++++++++++++++++++++++++++++++++++++++
 debian/rules                   | 16 ++++++++
 4 files changed, 111 insertions(+), 1 deletion(-)

diff --git a/debian/control b/debian/control
index 4bfe361..13292bf 100644
--- a/debian/control
+++ b/debian/control
@@ -4,7 +4,11 @@ Uploaders: Bas Couwenberg <sebastic at xs4all.nl>
 Section: science
 Priority: optional
 Build-Depends: debhelper (>= 9),
-               dh-autoreconf
+               dh-autoreconf,
+               docbook2x,
+               docbook-xsl,
+               docbook-xml,
+               xsltproc
 Standards-Version: 3.9.5
 Vcs-Browser: http://anonscm.debian.org/gitweb/?p=pkg-grass/laszip.git
 Vcs-Git: git://anonscm.debian.org/pkg-grass/laszip.git
diff --git a/debian/laszip-bin.manpages b/debian/laszip-bin.manpages
new file mode 100644
index 0000000..4842c90
--- /dev/null
+++ b/debian/laszip-bin.manpages
@@ -0,0 +1 @@
+debian/man/laszippertest.1
diff --git a/debian/man/laszippertest.1.xml b/debian/man/laszippertest.1.xml
new file mode 100644
index 0000000..09ea397
--- /dev/null
+++ b/debian/man/laszippertest.1.xml
@@ -0,0 +1,89 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<refentry id='laszippertest'>
+
+  <refmeta>
+    <refentrytitle>laszippertest</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>laszippertest</refname>
+    <refpurpose>test read/write performance using LASzip</refpurpose>
+  </refnamediv>
+
+  <refsynopsisdiv id='synopsis'>
+    <cmdsynopsis>
+      <command>laszippertest</command>
+      <arg choice='opt'><option>-n</option> <replaceable>NUMBER</replaceable></arg>
+      <arg choice='opt'><option>-s</option></arg>
+      <arg choice='opt'><option>-f</option></arg>
+      <arg choice='opt'><option>-r</option></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1 id='description'>
+    <title>DESCRIPTION</title>
+    <para>
+      <command>laszippertest</command> reads and writes point data in the LAS
+      1.X format compressed or uncompressed via the laszipper and lasunzipper
+      interfaces that are not (!) used by LASzip or LASlib but are the binding
+      to libLAS.
+    </para>
+  </refsect1>
+
+  <refsect1 id='options'>
+    <title>OPTIONS</title>
+
+    <variablelist>
+
+      <varlistentry>
+        <term><option>-n</option> <replaceable>NUMBER</replaceable></term>
+        <listitem>
+          <para>
+            number of points to process (default: 100000)
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-s</option></term>
+        <listitem>
+          <para>
+            use C++ stream I/O (default: use FILE* I/O)
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-f</option></term>
+        <listitem>
+          <para>
+            run forever (default: run just one pass)
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-r</option></term>
+        <listitem>
+          <para>
+            use random input data (default: use fixed data)
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-x</option></term>
+        <listitem>
+          <para>
+            set random seed, instead of current time (default: use time)
+          </para>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
+  </refsect1>
+
+</refentry>
diff --git a/debian/rules b/debian/rules
index 1f21886..300d98b 100755
--- a/debian/rules
+++ b/debian/rules
@@ -4,9 +4,25 @@
 
 VERBOSE=1
 
+MANPAGES:=$(wildcard debian/man/*.*.xml)
+
 %:
 	dh $@ --with autoreconf --parallel
 
+override_dh_clean:
+	dh_clean
+
+	rm -f debian/man/*.1
+
+override_dh_auto_build:
+	# Create man pages from DocBook XML
+	for x in $(MANPAGES) ; do \
+	  docbook2x-man $$x ; \
+	  mv `basename $$x | sed 's/.xml$$//'` `dirname $$x` ; \
+	done
+
+	dh_auto_build
+
 override_dh_install:
 	dh_install --list-missing
 

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