'\" -*- coding: us-ascii -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH spatialite_xml_load 1 "29 August 2015" "" ""
.SH NAME
spatialite_xml_load \- parse any XML document, and create and populate a DB-file 
.SH SYNOPSIS
'nh
.fi
.ad l
\fBspatialite_xml_load\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
[\fB-h\fR] [\fB-x\fR \fIpathname\fR] [\fB-d\fR \fIpathname\fR] [\fB-cg\fR] [\fB-xl\fR] [\fB-nl\fR \fInum\fR] [\fB-pl\fR \fInum\fR] [\fB-jo\fR] [\fB-cs\fR \fInum\fR] [\fB-m\fR]
'in \n(.iu-\nxu
.ad b
'hy
.SH DESCRIPTION
\fBspatialite_xml_load\fR 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.
.PP
The whole translation is performed in such a way so to be sure that
absolutely no information will be never lost or suppressed.
.PP
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.
.PP
There are no imposed size-limits: some huge GML files as big as many GBs
have been successfully loaded by using this tool.
.SH OPTIONS
.TP 
\*(T<\fB\-h\fR\*(T>, \*(T<\fB\-\-help\fR\*(T>
show help message
.TP 
\*(T<\fB\-x\fR\*(T> \fIpathname\fR, \*(T<\fB\-\-xml\-path\fR\*(T> \fIpathname\fR
the XML file path
.TP 
\*(T<\fB\-d\fR\*(T> \fIpathname\fR, \*(T<\fB\-\-db\-path\fR\*(T> \fIpathname\fR
the SpatiaLite DB path
.TP 
\*(T<\fB\-cg\fR\*(T>, \*(T<\fB\-\-collapsed\-gml\fR\*(T>
collapsed GML Geometries
.TP 
\*(T<\fB\-xl\fR\*(T>, \*(T<\fB\-\-xlink\-href\fR\*(T>
special GML xlink:href handling
.TP 
\*(T<\fB\-nl\fR\*(T> \fInum\fR, \*(T<\fB\-\-nl\-level\fR\*(T> \fInum\fR
tree-level for table-names (default: 0)
.TP 
\*(T<\fB\-pl\fR\*(T> \fInum\fR, \*(T<\fB\-\-parent\-levels\fR\*(T> \fInum\fR
how many ancestors for table-names (default: \e-1)
.TP 
\*(T<\fB\-jo\fR\*(T>, \*(T<\fB\-\-journal\-off\fR\*(T>
unsafe [but faster] mode
.TP 
\*(T<\fB\-cs\fR\*(T> \fInum\fR, \*(T<\fB\-\-cache\-size\fR\*(T> \fInum\fR
DB cache size (how many pages)
.TP 
\*(T<\fB\-m\fR\*(T>, \*(T<\fB\-\-in\-memory\fR\*(T>
using IN-MEMORY database