[SCM] spatialite-tools branch, master, updated. debian/4.0.0-1-33-ga7a885a

[Bas Couwenberg]

The following commit has been merged in the master branch:
commit cfe089424b2e048a2fe795d418c838abaa1ba9d2
Author: Bas Couwenberg <sebastic at xs4all.nl>
Date:   Mon Sep 30 04:36:27 2013 +0200

    Add man page for: exif_loader.

diff --git a/debian/changelog b/debian/changelog
index 2df84c8..ee9b47a 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -11,6 +11,9 @@ spatialite-tools (4.1.1-1) UNRELEASED; urgency=low
   * Pass all hardening flags to configure.
   * Add lintian override for no upstream changelog, link to timeline.
   * Add patch to fix 'successfully' typo.
+  * Add man page for specialite tools:
+    - exif_loader
+    (closes: #703344)
 
  -- Bas Couwenberg <sebastic at xs4all.nl>  Mon, 30 Sep 2013 02:35:52 +0200
 
diff --git a/debian/control b/debian/control
index 7c6584a..8630b6c 100644
--- a/debian/control
+++ b/debian/control
@@ -17,7 +17,11 @@ Build-Depends: debhelper (>= 8),
                libgeos-dev (>= 3.3.0),
                libproj-dev,
                libreadosm-dev,
-               zlib1g-dev
+               zlib1g-dev,
+               docbook2x,
+               docbook-xsl,
+               docbook-xml,
+               xsltproc
 Standards-Version: 3.9.3
 Vcs-Browser: http://anonscm.debian.org/gitweb/?p=pkg-grass/spatialite-tools.git
 Vcs-Git: git://anonscm.debian.org/pkg-grass/spatialite-tools.git
diff --git a/debian/man/exif_loader.1.xml b/debian/man/exif_loader.1.xml
new file mode 100644
index 0000000..9aeb133
--- /dev/null
+++ b/debian/man/exif_loader.1.xml
@@ -0,0 +1,112 @@
+<?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='exif_loader'>
+
+  <refmeta>
+    <refentrytitle>exif_loader</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>exif_loader</refname>
+    <refpurpose>upload JPEG/EXIF photos into a DB</refpurpose>
+  </refnamediv>
+
+  <refsynopsisdiv id='synopsis'>
+    <cmdsynopsis>
+      <command>exif_loader</command>
+      <arg choice='opt'><option>-h</option></arg>
+      <arg choice='opt'><option>-d</option> <replaceable>pathname</replaceable></arg>
+      <group>
+        <arg choice='opt'><option>-D</option> <replaceable>dir_path</replaceable></arg>
+        <arg choice='opt'><option>-f</option> <replaceable>file_name</replaceable></arg>
+      </group>
+      <group>
+        <arg choice='opt'><option>--any-exif</option></arg>
+        <arg choice='opt'><option>--gps-exif-only</option></arg>
+      </group>
+      <group>
+        <arg choice='opt'><option>--metadata</option></arg>
+        <arg choice='opt'><option>--no-metadata</option></arg>
+      </group>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1 id='description'>
+    <title>DESCRIPTION</title>
+    <para>
+      <command>exif_loader</command> is a tool for uploading JPEG/EXIF photos
+      into a DB, preserving full Exif metadata and building Geometry from GPS
+      tags (if present).
+    </para>
+  </refsect1>
+
+  <refsect1 id='options'>
+    <title>OPTIONS</title>
+    <variablelist>
+
+      <varlistentry>
+        <term><option>-h</option></term>
+        <term><option>--help</option></term>
+        <listitem>
+          <para>print help message</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-d</option> <replaceable>pathname</replaceable></term>
+        <term><option>--db-path</option> <replaceable>pathname</replaceable></term>
+        <listitem>
+          <para>the SpatiaLite db path</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-D</option> <replaceable>dir_path</replaceable></term>
+        <term><option>--dir</option> <replaceable>dir_path</replaceable></term>
+        <listitem>
+          <para>the DIR path containing EXIF files</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>-f</option> <replaceable>file_name</replaceable></term>
+        <term><option>--file-path</option> <replaceable>file_name</replaceable></term>
+        <listitem>
+          <para>a single EXIF file</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>--any-exif</option></term>
+        <listitem>
+          <para>don't limit to GPS only EXIF tags (default)</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>--gps-exif-only</option></term>
+        <listitem>
+          <para>only load GPS EXIF tags</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>--metadata</option></term>
+        <listitem>
+          <para>also load EXIF meta data (default)</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>--no-metadata</option></term>
+        <listitem>
+          <para>don't load any EXIF meta data</para>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
+  </refsect1>
+
+</refentry>
diff --git a/debian/rules b/debian/rules
index 845b2ff..c276dfe 100755
--- a/debian/rules
+++ b/debian/rules
@@ -11,6 +11,8 @@ FULL_VERSION := $(shell dpkg-parsechangelog | grep ^Version | cut -d' ' -f2 | cu
 VERSION := $(shell echo $(FULL_VERSION) | sed -e "s/~beta[[:digit:]]\+/-BETA/")
 LC_VERSION := $(shell echo $(VERSION) | tr A-Z a-z)
 
+MANPAGES := $(wildcard debian/man/*.*.xml)
+
 DEB_HOST_ARCH ?= $(shell dpkg-architecture -qDEB_HOST_ARCH)
 
 %:
@@ -20,6 +22,20 @@ versions:
 	@echo "Spatialite full version: $(FULL_VERSION)"
 	@echo "Spatialite version: $(LC_VERSION)"
 
+override_dh_clean:
+	dh_clean
+
+	-$(RM) -f $(CURDIR)/debian/man/*.1
+
 override_dh_auto_configure:
 	dh_auto_configure -- $(shell dpkg-buildflags --export=configure)
 
+override_dh_auto_build:
+	# Create man page from DocBook XML
+	for x in $(MANPAGES) ; do \
+	    docbook2x-man $$x ; \
+	    mv `basename $$x | sed 's/.xml$$//'` `dirname $$x` ; \
+	done
+
+	dh_auto_build
+
diff --git a/debian/spatialite-bin.manpages b/debian/spatialite-bin.manpages
new file mode 100644
index 0000000..9e837c4
--- /dev/null
+++ b/debian/spatialite-bin.manpages
@@ -0,0 +1 @@
+debian/man/exif_loader.1

-- 
Spatialite Tools