[spatialite-tools] 11/14: Add man page for spatialite_xml_load.
Bas Couwenberg
sebastic at xs4all.nl
Mon Aug 4 01:35:42 UTC 2014
This is an automated email from the git hooks/post-receive script.
sebastic-guest pushed a commit to branch experimental
in repository spatialite-tools.
commit 6151f9ecdcffe26762ab7d5c60751c6e95c8beae
Author: Bas Couwenberg <sebastic at xs4all.nl>
Date: Mon Aug 4 02:44:48 2014 +0200
Add man page for spatialite_xml_load.
---
debian/changelog | 1 +
debian/man/spatialite_xml_load.1.xml | 145 +++++++++++++++++++++++++++++++++++
debian/spatialite-bin.manpages | 1 +
3 files changed, 147 insertions(+)
diff --git a/debian/changelog b/debian/changelog
index 1b2ee19..ba3345b 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -10,6 +10,7 @@ spatialite-tools (4.2.0-1) UNRELEASED; urgency=medium
* Update copyright file.
* Add man page for:
- spatialite_xml_collapse
+ - spatialite_xml_load
-- Bas Couwenberg <sebastic at xs4all.nl> Mon, 04 Aug 2014 00:14:56 +0200
diff --git a/debian/man/spatialite_xml_load.1.xml b/debian/man/spatialite_xml_load.1.xml
new file mode 100644
index 0000000..eb89f7c
--- /dev/null
+++ b/debian/man/spatialite_xml_load.1.xml
@@ -0,0 +1,145 @@
+<?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_xml_load'>
+
+ <refmeta>
+ <refentrytitle>spatialite_xml_load</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </refmeta>
+
+ <refnamediv>
+ <refname>spatialite_xml_load</refname>
+ <refpurpose>
+ parse any XML document, and create and populate a DB-file
+ </refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv id='synopsis'>
+ <cmdsynopsis>
+ <command>spatialite_xml_load</command>
+ <arg choice='opt'><option>-h</option></arg>
+ <arg choice='opt'><option>-x</option> <replaceable>pathname</replaceable></arg>
+ <arg choice='opt'><option>-d</option> <replaceable>pathname</replaceable></arg>
+ <arg choice='opt'><option>-cg</option></arg>
+ <arg choice='opt'><option>-xl</option></arg>
+ <arg choice='opt'><option>-nl</option> <replaceable>num</replaceable></arg>
+ <arg choice='opt'><option>-pl</option> <replaceable>num</replaceable></arg>
+ <arg choice='opt'><option>-jo</option></arg>
+ <arg choice='opt'><option>-cs</option> <replaceable>num</replaceable></arg>
+ <arg choice='opt'><option>-m</option></arg>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+
+ <refsect1 id='description'>
+ <title>DESCRIPTION</title>
+ <para>
+ <command>spatialite_xml_load</command> will parse any generic XML
+ document of unlimited complexity, and will consequently create and
+ populate a DB-file faithfully translating the XML tree into many
+ relationally joined DBMS tables.
+ </para>
+ <para>
+ The whole translation is performed in such a way so to be sure that
+ absolutely no information will be never lost or suppressed.
+ </para>
+ <para>
+ If two (or even more) XML files share exactly the same identical
+ logical layout (i.e. they all support the same identical formal schema
+ definition) this tool is capable to merge all them within the same
+ DB-file.
+ </para>
+ <para>
+ There are no imposed size-limits: some huge GML files as big as many GBs
+ have been successfully loaded by using this tool.
+ </para>
+ </refsect1>
+
+ <refsect1 id='options'>
+ <title>OPTIONS</title>
+ <variablelist>
+
+ <varlistentry>
+ <term><option>-h</option></term>
+ <term><option>--help</option></term>
+ <listitem>
+ <para>show help message</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-x</option> <replaceable>pathname</replaceable></term>
+ <term><option>--xml-path</option> <replaceable>pathname</replaceable></term>
+ <listitem>
+ <para>the XML file path</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>-cg</option></term>
+ <term><option>--collapsed-gml</option></term>
+ <listitem>
+ <para>collapsed GML Geometries</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-xl</option></term>
+ <term><option>--xlink-href</option></term>
+ <listitem>
+ <para>special GML xlink:href handling</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-nl</option> <replaceable>num</replaceable></term>
+ <term><option>--nl-level</option> <replaceable>num</replaceable></term>
+ <listitem>
+ <para>tree-level for table-names (default: 0)</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-pl</option> <replaceable>num</replaceable></term>
+ <term><option>--parent-levels</option> <replaceable>num</replaceable></term>
+ <listitem>
+ <para>how many ancestors for table-names (default: \-1)</para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-jo</option></term>
+ <term><option>--journal-off</option></term>
+ <listitem>
+ <para>unsafe [but faster] mode</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>-m</option></term>
+ <term><option>--in-memory</option></term>
+ <listitem>
+ <para>using IN-MEMORY database</para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ </refsect1>
+
+</refentry>
diff --git a/debian/spatialite-bin.manpages b/debian/spatialite-bin.manpages
index 77501bd..672f947 100644
--- a/debian/spatialite-bin.manpages
+++ b/debian/spatialite-bin.manpages
@@ -11,3 +11,4 @@ debian/man/spatialite_osm_net.1
debian/man/spatialite_osm_raw.1
debian/man/spatialite_tool.1
debian/man/spatialite_xml_collapse.1
+debian/man/spatialite_xml_load.1
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-grass/spatialite-tools.git
More information about the Pkg-grass-devel
mailing list