[librasterlite2] 10/12: Add man pages.
Bas Couwenberg
sebastic at xs4all.nl
Fri Nov 21 22:27:44 UTC 2014
This is an automated email from the git hooks/post-receive script.
sebastic-guest pushed a commit to branch master
in repository librasterlite2.
commit 04756921986ba47d8191c1b480a6d62fcd325be5
Author: Bas Couwenberg <sebastic at xs4all.nl>
Date: Fri Nov 21 21:24:11 2014 +0100
Add man pages.
---
debian/control | 6 +-
debian/man/rl2tool.1.xml | 829 ++++++++++++++++++++++++++++++++++++++++
debian/man/spatialite.1.xml | 179 +++++++++
debian/man/wmslite.1.xml | 71 ++++
debian/rasterlite2-bin.manpages | 1 +
debian/rules | 11 +
6 files changed, 1096 insertions(+), 1 deletion(-)
diff --git a/debian/control b/debian/control
index ce0dfe4..a72d177 100644
--- a/debian/control
+++ b/debian/control
@@ -18,7 +18,11 @@ Build-Depends: debhelper (>= 9),
libwebp-dev,
libxml2-dev,
pkg-config,
- zlib1g-dev
+ zlib1g-dev,
+ docbook2x,
+ docbook-xsl,
+ docbook-xml,
+ xsltproc
Standards-Version: 3.9.6
Vcs-Browser: http://anonscm.debian.org/gitweb/?p=pkg-grass/librasterlite2.git
Vcs-Git: git://anonscm.debian.org/pkg-grass/librasterlite2.git
diff --git a/debian/man/rl2tool.1.xml b/debian/man/rl2tool.1.xml
new file mode 100644
index 0000000..706d223
--- /dev/null
+++ b/debian/man/rl2tool.1.xml
@@ -0,0 +1,829 @@
+<?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='rl2tool'>
+
+ <refmeta>
+ <refentrytitle>rl2tool</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </refmeta>
+
+ <refnamediv>
+ <refname>rl2tool</refname>
+ <refpurpose>CLI tool for RasterLite2</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv id='synopsis'>
+ <cmdsynopsis>
+ <command>rl2tool</command>
+ <arg choice='plaint'><replaceable>mode</replaceable></arg>
+ <arg choice='opt'><replaceable>ARGLIST</replaceable></arg>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+
+ <refsect1 id='description'>
+ <title>DESCRIPTION</title>
+ <para>
+ <command>rl2tool</command> is a CLI tool for RasterLite2.
+ </para>
+ </refsect1>
+
+ <refsect1 id='options'>
+ <title>OPTIONS</title>
+
+ <!-- CREATE -->
+
+ <para>Mode: CREATE</para>
+ <para>
+ will create a new RasterLite2 Raster Coverage
+ </para>
+
+ <variablelist>
+
+ <varlistentry>
+ <term><option>-db</option> <replaceable>pathname</replaceable></term>
+ <term><option>--db-path</option> <replaceable>pathname</replaceable></term>
+ <listitem>
+ <para>RasterLite2 DB path</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-cov</option> <replaceable>string</replaceable></term>
+ <term><option>--coverage</option> <replaceable>string</replaceable></term>
+ <listitem>
+ <para>Coverage's name</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-smp</option> <replaceable>keyword</replaceable></term>
+ <term><option>--sample-type</option> <replaceable>keyword</replaceable></term>
+ <listitem>
+ <para>Sample Type keyword (see list)</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-pxl</option> <replaceable>keyword</replaceable></term>
+ <term><option>--pixel-type</option> <replaceable>keyword</replaceable></term>
+ <listitem>
+ <para>Pixel Type keyword (see list)</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-bds</option> <replaceable>integer</replaceable></term>
+ <term><option>--num-bands</option> <replaceable>integer</replaceable></term>
+ <listitem>
+ <para>Number of Bands</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-cpr</option> <replaceable>keyword</replaceable></term>
+ <term><option>--compression</option> <replaceable>keyword</replaceable></term>
+ <listitem>
+ <para>Compression keyword (see list)</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-qty</option> <replaceable>integer</replaceable></term>
+ <term><option>--quality</option> <replaceable>integer</replaceable></term>
+ <listitem>
+ <para>Compression Quality [0-100]</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-tlw</option> <replaceable>integer</replaceable></term>
+ <term><option>--tile-width</option> <replaceable>integer</replaceable></term>
+ <listitem>
+ <para>Tile Width [pixels]</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-tlh</option> <replaceable>integer</replaceable></term>
+ <term><option>--tile-height</option> <replaceable>integer</replaceable></term>
+ <listitem>
+ <para>Tile Height [pixels]</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-srid</option> <replaceable>integer</replaceable></term>
+ <term><option>--srid</option> <replaceable>integer</replaceable></term>
+ <listitem>
+ <para>SRID value</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-nosrid</option></term>
+ <term><option>--no-srid</option></term>
+ <listitem>
+ <para>No SRID</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-res</option> <replaceable>number</replaceable></term>
+ <term><option>--resolution</option> <replaceable>number</replaceable></term>
+ <listitem>
+ <para>pixel resolution(X and Y)</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-xres</option> <replaceable>number</replaceable></term>
+ <term><option>--x-resol</option> <replaceable>number</replaceable></term>
+ <listitem>
+ <para>pixel resolution(X specific)</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-yres</option> <replaceable>number</replaceable></term>
+ <term><option>--y-resol</option> <replaceable>number</replaceable></term>
+ <listitem>
+ <para>pixel resolution(Y specific)</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-nd</option> <replaceable>pixel</replaceable></term>
+ <term><option>--no-data</option> <replaceable>pixel</replaceable></term>
+ <listitem>
+ <para>NO-DATA pixel value</para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <para>
+ SampleType Keywords:
+ </para>
+ <para>
+ 1-BIT 2-BIT 4-BIT INT8 UINT8 INT16 UINT16
+ INT32 UINT32 FLOAT DOUBLE
+ </para>
+
+ <para>
+ PixelType Keywords:
+ </para>
+ <para>
+ MONOCHROME PALETTE GRAYSCALE RGB MULTIBAND DATAGRID
+ </para>
+
+ <para>
+ Compression Keywords:
+ </para>
+ <para>
+ NONE DEFLATE LZMA GIF PNG JPEG WEBP LL_WEBP FAX3 FAX4
+ </para>
+
+ <!-- DROP -->
+
+ <para>Mode: DROP</para>
+ <para>will drop an existing RasterLite2 Raster Coverage</para>
+
+ <variablelist>
+
+ <varlistentry>
+ <term><option>-db</option> <replaceable>pathname</replaceable></term>
+ <term><option>--db-path</option> <replaceable>pathname</replaceable></term>
+ <listitem>
+ <para>RasterLite2 DB path</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-cov</option> <replaceable>string</replaceable></term>
+ <term><option>--coverage</option> <replaceable>string</replaceable></term>
+ <listitem>
+ <para>Coverage's name</para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <!-- IMPORT -->
+
+ <para>Mode: IMPORT</para>
+ <para>
+ will create a new Raster Section by importing an external
+ image or raster file
+ </para>
+
+ <variablelist>
+
+ <varlistentry>
+ <term><option>-db</option> <replaceable>pathname</replaceable></term>
+ <term><option>--db-path</option> <replaceable>pathname</replaceable></term>
+ <listitem>
+ <para>RasterLite2 DB path</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-src</option> <replaceable>pathname</replaceable></term>
+ <term><option>--src-path</option> <replaceable>pathname</replaceable></term>
+ <listitem>
+ <para>input Image/Raster path</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-dir</option> <replaceable>pathname</replaceable></term>
+ <term><option>--dir-path</option> <replaceable>pathname</replaceable></term>
+ <listitem>
+ <para>input directory path</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-ext</option> <replaceable>string</replaceable></term>
+ <term><option>--file-ext</option> <replaceable>string</replaceable></term>
+ <listitem>
+ <para>extension file extension (e.g. .tif)</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-cov</option> <replaceable>string</replaceable></term>
+ <term><option>--coverage</option> <replaceable>string</replaceable></term>
+ <listitem>
+ <para>Coverage's name</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-srid</option> <replaceable>integer</replaceable></term>
+ <term><option>--srid</option> <replaceable>integer</replaceable></term>
+ <listitem>
+ <para>optional: force SRID value</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-wf</option>></term>
+ <term><option>--worldfile</option></term>
+ <listitem>
+ <para>requires a Worldfile</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-pyr</option></term>
+ <term><option>--pyramidize</option></term>
+ <listitem>
+ <para>immediately build Pyramid levels</para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <!-- EXPORT -->
+
+ <para>Mode: EXPORT</para>
+ <para>
+ will export an external image from a Coverage
+ </para>
+
+ <variablelist>
+
+ <varlistentry>
+ <term><option>-db</option> <replaceable>pathname</replaceable></term>
+ <term><option>--db-path</option> <replaceable>pathname</replaceable></term>
+ <listitem>
+ <para>RasterLite2 DB path</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-dst</option> <replaceable>pathname</replaceable></term>
+ <term><option>--dst-path</option> <replaceable>pathname</replaceable></term>
+ <listitem>
+ <para>output Image/Raster path</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-cov</option> <replaceable>string</replaceable></term>
+ <term><option>--coverage</option> <replaceable>string</replaceable></term>
+ <listitem>
+ <para>Coverage's name</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-res</option> <replaceable>number</replaceable></term>
+ <term><option>--resolution</option> <replaceable>number</replaceable></term>
+ <listitem>
+ <para>pixel resolution (X and Y)</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-xres</option> <replaceable>number</replaceable></term>
+ <term><option>--x-resol</option> <replaceable>number</replaceable></term>
+ <listitem>
+ <para>pixel resolution (X specific)</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-yres</option> <replaceable>number</replaceable></term>
+ <term><option>--y-resol</option> <replaceable>number</replaceable></term>
+ <listitem>
+ <para>pixel resolution (Y specific)</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-minx</option> <replaceable>number</replaceable></term>
+ <term><option>--min-x</option> <replaceable>number</replaceable></term>
+ <listitem>
+ <para>X coordinate (lower-left corner)</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-miny</option> <replaceable>number</replaceable></term>
+ <term><option>--min-y</option> <replaceable>number</replaceable></term>
+ <listitem>
+ <para>Y coordinate (lower-left corner)</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-maxx</option> <replaceable>number</replaceable></term>
+ <term><option>--max-x</option> <replaceable>number</replaceable></term>
+ <listitem>
+ <para>X coordinate (upper-right corner)</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-maxy</option> <replaceable>number</replaceable></term>
+ <term><option>--max-y</option> <replaceable>number</replaceable></term>
+ <listitem>
+ <para>Y coordinate (upper-left corner)</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-cx</option> <replaceable>number</replaceable></term>
+ <term><option>--center-x</option> <replaceable>number</replaceable></term>
+ <listitem>
+ <para>X coordinate (center)</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-cy</option> <replaceable>number</replaceable></term>
+ <term><option>--center-y</option> <replaceable>number</replaceable></term>
+ <listitem>
+ <para>Y coordinate (center)</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-outw</option> <replaceable>number</replaceable></term>
+ <term><option>--out-width</option> <replaceable>number</replaceable></term>
+ <listitem>
+ <para>image width (in pixels)</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-outh</option> <replaceable>number</replaceable></term>
+ <term><option>--out-height</option> <replaceable>number</replaceable></term>
+ <listitem>
+ <para>image height (in pixels)</para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <para>
+ In order to export a raster you are expected to specify:
+ <variablelist>
+
+ <varlistentry>
+ <listitem>
+ <para>
+ - the intended resolution (<option>-res</option> OR <option>-xres</option> AND <option>-yres</option>)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <listitem>
+ <para>
+ - the output image size (<option>-outw</option> AND <option>-outh</option>)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <listitem>
+ <para>
+ - a single tie-point, defined as one of:
+ <variablelist>
+
+ <varlistentry>
+ <listitem>
+ <para>
+ - Output Image Center point: <option>-cx</option> AND <option>-cy</option>
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <listitem>
+ <para>
+ - Output Image LowerLeft corner: <option>-minx</option> AND <option>-miny</option>
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <listitem>
+ <para>
+ - Output Image LowerRight corner: <option>-maxx</option> AND <option>-miny</option>
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <listitem>
+ <para>
+ - Output Image UpperLeft corner: <option>-minx</option> AND <option>-maxy</option>
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <listitem>
+ <para>
+ - Output Image UpperRight corner: <option>-maxx</option> AND <option>-maxy</option>
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+ </para>
+
+ <!-- DELETE -->
+
+ <para>Mode: DELETE</para>
+ <para>
+ will delete a Raster Section
+ </para>
+
+ <variablelist>
+
+ <varlistentry>
+ <term><option>-db</option> <replaceable>pathname</replaceable></term>
+ <term><option>--db-path</option> <replaceable>pathname</replaceable></term>
+ <listitem>
+ <para>RasterLite2 DB path</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-cov</option> <replaceable>string</replaceable></term>
+ <term><option>--coverage</option> <replaceable>string</replaceable></term>
+ <listitem>
+ <para>Coverage's name</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-sec</option> <replaceable>string</replaceable></term>
+ <term><option>--section</option> <replaceable>string</replaceable></term>
+ <listitem>
+ <para>Section's name</para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <!-- PYRAMIDIZE -->
+
+ <para>Mode: PYRAMIDIZE</para>
+ <para>will (re)build all Pyramid levels supporting a Coverage</para>
+
+ <variablelist>
+
+ <varlistentry>
+ <term><option>-db</option> <replaceable>pathname</replaceable></term>
+ <term><option>--db-path</option> <replaceable>pathname</replaceable></term>
+ <listitem>
+ <para>RasterLite2 DB path</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-cov</option> <replaceable>string</replaceable></term>
+ <term><option>--coverage</option> <replaceable>string</replaceable></term>
+ <listitem>
+ <para>Coverage's name</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-sec</option> <replaceable>string</replaceable></term>
+ <term><option>--section</option> <replaceable>string</replaceable></term>
+ <listitem>
+ <para>optional: Section's name</para>
+ <para>default is "All Sections"</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-f</option></term>
+ <term><option>--force</option></term>
+ <listitem>
+ <para>optional: rebuilds from scratch</para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <!-- PYRAMIDIZE MONOLITHIC -->
+
+ <para>Mode: PYRAMIDIZE-MONOLITHIC</para>
+ <para>
+ will (re)build all Pyramid levels (Monolithic) supporting a Coverage
+ </para>
+
+ <variablelist>
+
+ <varlistentry>
+ <term><option>-db</option> <replaceable>pathname</replaceable></term>
+ <term><option>--db-path</option> <replaceable>pathname</replaceable></term>
+ <listitem>
+ <para>RasterLite2 DB path</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-cov</option> <replaceable>string</replaceable></term>
+ <term><option>--coverage</option> <replaceable>string</replaceable></term>
+ <listitem>
+ <para>Coverage's name</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-lev</option> <replaceable>number</replaceable></term>
+ <term><option>--virt-levels</option> <replaceable>number</replaceable></term>
+ <listitem>
+ <para>number of virt-levels</para>
+ <para>could be one of: 1, 2 or 3</para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <!-- DE-PYRAMIDIZE -->
+
+ <para>Mode: DE-PYRAMIDIZE</para>
+ <para>
+ will delete Pyramid levels
+ </para>
+
+ <variablelist>
+
+ <varlistentry>
+ <term><option>-db</option> <replaceable>pathname</replaceable></term>
+ <term><option>--db-path</option> <replaceable>pathname</replaceable></term>
+ <listitem>
+ <para>RasterLite2 DB path</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-cov</option> <replaceable>string</replaceable></term>
+ <term><option>--coverage</option> <replaceable>string</replaceable></term>
+ <listitem>
+ <para>Coverage's name</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-sec</option> <replaceable>string</replaceable></term>
+ <term><option>--section</option> <replaceable>string</replaceable></term>
+ <listitem>
+ <para>optional: Section's name</para>
+ <para>default is "All Sections"</para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <!-- LIST -->
+
+ <para>Mode: LIST</para>
+ <para>
+ will list Raster Sections within a Coverage
+ </para>
+
+ <variablelist>
+
+ <varlistentry>
+ <term><option>-db</option> <replaceable>pathname</replaceable></term>
+ <term><option>--db-path</option> <replaceable>pathname</replaceable></term>
+ <listitem>
+ <para>RasterLite2 DB path</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-cov</option> <replaceable>string</replaceable></term>
+ <term><option>--coverage</option> <replaceable>string</replaceable></term>
+ <listitem>
+ <para>Coverage's name</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-sec</option> <replaceable>string</replaceable></term>
+ <term><option>--section</option> <replaceable>string</replaceable></term>
+ <listitem>
+ <para>optional: Section's name</para>
+ <para>default is "All Sections"</para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <!-- MAP -->
+
+ <para>Mode: MAP</para>
+ <para>
+ will output a PNG Map representing all Raster Sections within a Coverage
+ </para>
+
+ <variablelist>
+
+ <varlistentry>
+ <term><option>-db</option> <replaceable>pathname</replaceable></term>
+ <term><option>--db-path</option> <replaceable>pathname</replaceable></term>
+ <listitem>
+ <para>RasterLite2 DB path</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-cov</option> <replaceable>string</replaceable></term>
+ <term><option>--coverage</option> <replaceable>string</replaceable></term>
+ <listitem>
+ <para>Coverage's name</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-dst</option> <replaceable>pathname</replaceable></term>
+ <term><option>--dst-path</option> <replaceable>pathname</replaceable></term>
+ <listitem>
+ <para>output Image/Raster path</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-outw</option> <replaceable>number</replaceable></term>
+ <term><option>--out-width</option> <replaceable>number</replaceable></term>
+ <listitem>
+ <para>image width (in pixels)</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-outh</option> <replaceable>number</replaceable></term>
+ <term><option>--out-height</option> <replaceable>number</replaceable></term>
+ <listitem>
+ <para>image height (in pixels)</para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <!-- CATALOG -->
+
+ <para>Mode: CATALOG</para>
+ <para>
+ will list all Coverages from within a RasterLite2 DB
+ </para>
+
+ <variablelist>
+
+ <varlistentry>
+ <term><option>-db</option> <replaceable>pathname</replaceable></term>
+ <term><option>--db-path</option> <replaceable>pathname</replaceable></term>
+ <listitem>
+ <para>RasterLite2 DB path</para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <!-- HISTOGRAM -->
+
+ <para>Mode: HISTOGRAM</para>
+ <para>
+ will create a PNG showing a band Histogram
+ </para>
+
+ <variablelist>
+
+ <varlistentry>
+ <term><option>-db</option> <replaceable>pathname</replaceable></term>
+ <term><option>--db-path</option> <replaceable>pathname</replaceable></term>
+ <listitem>
+ <para>RasterLite2 DB path</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-cov</option> <replaceable>string</replaceable></term>
+ <term><option>--coverage</option> <replaceable>string</replaceable></term>
+ <listitem>
+ <para>Coverage's name</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-sec</option> <replaceable>string</replaceable></term>
+ <term><option>--section</option> <replaceable>string</replaceable></term>
+ <listitem>
+ <para>optional: Section's name</para>
+ <para>default is "All Sections"</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-bnd</option> <replaceable>integer</replaceable></term>
+ <term><option>--band-index</option> <replaceable>integer</replaceable></term>
+ <listitem>
+ <para>a valid band index</para>
+ <para>default is band index 0</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-dst</option> <replaceable>pathname</replaceable></term>
+ <term><option>--dst-path</option> <replaceable>pathname</replaceable></term>
+ <listitem>
+ <para>output PNG path</para>
+ <para> default is <filename>./hist_cov_sec_idx.png</filename></para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <!-- DB options -->
+
+ <para>
+ optional DB specific settings:
+ </para>
+
+ <variablelist>
+
+ <varlistentry>
+ <term><option>-cs</option> <replaceable>num</replaceable></term>
+ <term><option>--cache-size</option> <replaceable>num</replaceable></term>
+ <listitem>
+ <para>DB cache size (how many pages)</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-m</option></term>
+ <term><option>--in-memory</option></term>
+ <listitem>
+ <para>using IN-MEMORY database</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-jo</option></term>
+ <term><option>--journal-off</option></term>
+ <listitem>
+ <para>unsafe [but faster] mode</para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ </refsect1>
+
+</refentry>
diff --git a/debian/man/spatialite.1.xml b/debian/man/spatialite.1.xml
new file mode 100644
index 0000000..5b007fb
--- /dev/null
+++ b/debian/man/spatialite.1.xml
@@ -0,0 +1,179 @@
+<?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='spatialite'>
+
+ <refmeta>
+ <refentrytitle>spatialite</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </refmeta>
+
+ <refnamediv>
+ <refname>spatialite</refname>
+ <refpurpose>CLI backend for SpatiaLite</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv id='synopsis'>
+ <cmdsynopsis>
+ <command>spatialite</command>
+ <arg choice='opt'><replaceable>OPTIONS</replaceable></arg>
+ <arg choice='plain'><replaceable>FILENAME</replaceable></arg>
+ <arg choice='opt'><replaceable>SQL</replaceable></arg>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+
+ <refsect1 id='description'>
+ <title>DESCRIPTION</title>
+ <para>
+ <command>spatialite</command> is a CLI backend for SpatiaLite.
+ </para>
+ </refsect1>
+
+ <refsect1 id='options'>
+ <title>OPTIONS</title>
+ <variablelist>
+
+ <varlistentry>
+ <term><option>-bail</option></term>
+ <listitem>
+ <para>stop after hitting an error</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-batch</option></term>
+ <listitem>
+ <para>force batch I/O</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-column</option></term>
+ <listitem>
+ <para>set output mode to 'column'</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-cmd</option> <replaceable>command</replaceable></term>
+ <listitem>
+ <para>run <replaceable>command</replaceable> before reading stdin</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-csv</option></term>
+ <listitem>
+ <para>set output mode to 'csv'</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-echo</option></term>
+ <listitem>
+ <para>print commands before execution</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-init</option> <replaceable>filename</replaceable></term>
+ <listitem>
+ <para>read/process named file</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-[no]header</option></term>
+ <listitem>
+ <para>turn headers on or off</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-help</option></term>
+ <listitem>
+ <para>show help message</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-html</option></term>
+ <listitem>
+ <para>set output mode to HTML</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-interactive</option></term>
+ <listitem>
+ <para>force interactive I/O</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-line</option></term>
+ <listitem>
+ <para>set output mode to 'line'</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-list</option></term>
+ <listitem>
+ <para>set output mode to 'list'</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-multiplex</option></term>
+ <listitem>
+ <para>enable the multiplexor VFS (if support built in)</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-nullvalue</option> '<replaceable>text</replaceable>'</term>
+ <listitem>
+ <para>set text string for NULL values</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-separator</option> '<replaceable>x</replaceable>'</term>
+ <listitem>
+ <para>set output field separator (|)</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-stats</option></term>
+ <listitem>
+ <para>print memory stats before each finalize</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-version</option></term>
+ <listitem>
+ <para>show SQLite version</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-vfs</option> <replaceable>NAME</replaceable></term>
+ <listitem>
+ <para>use NAME as the default VFS</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-vfstrace</option></term>
+ <listitem>
+ <para>enable tracing of all VFS calls (if support built in)</para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ </refsect1>
+
+</refentry>
diff --git a/debian/man/wmslite.1.xml b/debian/man/wmslite.1.xml
new file mode 100644
index 0000000..941b741
--- /dev/null
+++ b/debian/man/wmslite.1.xml
@@ -0,0 +1,71 @@
+<?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='wmslite'>
+
+ <refmeta>
+ <refentrytitle>wmslite</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </refmeta>
+
+ <refnamediv>
+ <refname>wmslite</refname>
+ <refpurpose>light-weight WMS server supporting RasterLite2 DataSources</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv id='synopsis'>
+ <cmdsynopsis>
+ <command>wmslite</command>
+ <arg choice='plain'><replaceable>ARGLIST</replaceable></arg>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+
+ <refsect1 id='description'>
+ <title>DESCRIPTION</title>
+ <para>
+ <command>wmslite</command> is a light-weight WMS server supporting
+ RasterLite2 DataSources.
+ </para>
+ </refsect1>
+
+ <refsect1 id='options'>
+ <title>OPTIONS</title>
+
+ <variablelist>
+
+ <varlistentry>
+ <term><option>-db</option> <replaceable>pathname</replaceable></term>
+ <term><option>--db-path</option> <replaceable>pathname</replaceable></term>
+ <listitem>
+ <para>RasterLite2 DB path</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-p</option> <replaceable>number</replaceable></term>
+ <term><option>--ip-port</option> <replaceable>number</replaceable></term>
+ <listitem>
+ <para>IP port number [default: 8080]</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-cs</option> <replaceable>num</replaceable></term>
+ <term><option>--cache-size</option> <replaceable>num</replaceable></term>
+ <listitem>
+ <para>DB cache size (how many pages)</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-dbg</option></term>
+ <term><option>--debug</option></term>
+ <listitem>
+ <para>verbose debugging mode</para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ </refsect1>
+
+</refentry>
diff --git a/debian/rasterlite2-bin.manpages b/debian/rasterlite2-bin.manpages
new file mode 100644
index 0000000..13cdaf4
--- /dev/null
+++ b/debian/rasterlite2-bin.manpages
@@ -0,0 +1 @@
+debian/man/*.1
diff --git a/debian/rules b/debian/rules
index 5c9fe63..d2c88a6 100755
--- a/debian/rules
+++ b/debian/rules
@@ -8,11 +8,22 @@ export VERBOSE=1
UPSTREAM_VERSION=$(shell dpkg-parsechangelog | sed -ne 's/^Version: \(.*\)-.*/\1/p' | sed -e 's/~.*//')
+MANPAGES := $(wildcard debian/man/*.*.xml)
+
%:
dh $@ \
--parallel \
--with autoreconf
+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
+
override_dh_auto_test:
dh_auto_test || echo "Ignoring test failures"
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-grass/librasterlite2.git
More information about the Pkg-grass-devel
mailing list