Added manual pages provided by Roberto Boati <roberto.boati@daisyred.com>

git-svn-id: http://svn.osgeo.org/postgis/trunk@1589 b70326c6-7e19-0410-871a-916f4a2858ee

diff --git a/doc/Makefile b/doc/Makefile
index a573efccb69fc7ea2acabb50125c209fe5ef838f..86ab15a2e2f2712ad62b57e1af32e0f88f26da99 100644 (file)
--- a/doc/Makefile
+++ b/doc/Makefile
@@ -66,5 +66,6 @@ clean:
 maintainer-clean: clean
        @rm -f html/*.html
 
+install: html/postgis.html man/shp2pgsql.1 man/pgsql2shp.1
 
 .PHONY: html 

diff --git a/doc/man/pgsql2shp.1 b/doc/man/pgsql2shp.1
new file mode 100644 (file)
index 0000000..03f8cbb
--- /dev/null
+++ b/doc/man/pgsql2shp.1
@@ -0,0 +1,69 @@
+.TH "pgsql2shp" "1" "" "" "PostGIS"
+.SH "NAME"
+.LP 
+pgsql2shp - postgis to shapefile dumper
+.SH "SYNTAX"
+.LP 
+pgsql2shp [\fIoptions\fR] \fIdatabase\fR [\fIschema\fR\fB.\fR]\fItable\fR
+.br 
+pgsql2shp [\fIoptions\fR] \fIdatabase\fR \fIquery\fR
+.SH "DESCRIPTION"
+.LP 
+The pgsql2shp table dumper connects directly to the database and converts a table (possibly created by user query) into a shape file. It is compatible with
+all versions of PostGIS.
+.SH "OPTIONS"
+.LP 
+The commandline options are:
+
+.TP 
+\fB\-f\fR <\fIfilename\fR>
+Write the output to a particular filename.
+
+.TP 
+\fB\-h\fR <\fIhost\fR>
+The database host to connect to.
+
+.TP 
+\fB\-p\fR <\fIport\fR>
+The port to connect to on the database host.
+
+
+.TP 
+\fB\-P\fR <\fIpassword\fR>
+The password to use when connecting to the database.
+
+
+.TP 
+\fB\-u\fR <\fIuser\fR>
+The username to use when connecting to the database.
+
+.TP 
+\fB\-g\fR <\fIgeometry column\fR>
+In the case of tables with multiple geometry columns, the geometry column to use when writing the shape file.
+
+.TP 
+\fB\-b\fR
+Use a binary cursor. When used on pre\-1.0.0 PostGIS versions this will reduce the likelihood of coordinate drift due to conversion to and from WKT format. 
+Coordinate drifts will not occur with PostGIS 1.0.0 and newer versions.
+It will be slightly faster, but might fail if any NON\-gemetry column lacks
+a cast to text.
+
+.TP 
+\fB\-r\fR
+Raw mode. Do not drop the gid field, or escape column names.
+
+.TP 
+\fB\-d\fR
+For backward compatibility: write a 3\-dimensional shape file when dumping from old (pre\-1.0.0) postgis databases (the default is to write a 2\-dimensional shape file in that case). Starting from postgis\-1.0.0+, dimensions are fully encoded. 
+
+
+.SH "AUTHORS"
+.LP
+Originally written by Jeff Lounsbury <jeffloun@refractions.net>.
+Improved and maintained by Sandro Santilli <strk@refractions.net>.
+
+This application uses functionality from shapelib 1.2.9
+by Frank Warmerdam <warmerda@gdal.velocet.ca> to write to ESRI Shape files.
+.SH "SEE ALSO"
+.LP 
+shp2pgsql(1)

diff --git a/doc/man/shp2pgsql.1 b/doc/man/shp2pgsql.1
new file mode 100644 (file)
index 0000000..b4d4881
--- /dev/null
+++ b/doc/man/shp2pgsql.1
@@ -0,0 +1,64 @@
+.TH "shp2pgsql" "1" "" "" "PostGIS"
+.SH "NAME"
+.LP 
+shp2pgsql - shapefile to postgis loader
+.SH "SYNTAX"
+.LP 
+shp2pgsql [\fIoptions\fR] \fIshapefile\fR [\fIschema\fR\fB.\fR]\fItable\fR
+.SH "DESCRIPTION"
+.LP 
+The shp2pgsql data loader converts ESRI Shape files into SQL suitable for insertion into a PostGIS/PostgreSQL database. Produced output is NOT compatible
+with pre\-1.0.0 versions of PostGIS.
+.SH "OPTIONS"
+.LP 
+The loader has several operating modes distinguished by command line flags:
+
+.TP 
+\fB\-d\fR
+Drops the database table before creating a new table with the data in the Shape file.
+
+.TP 
+\fB\-a\fR
+Appends data from the Shape file into the database table. Note that to use this option to load multiple files, the files must have the same attributes and same data types.
+
+.TP 
+\fB\-c\fR
+Creates a new table and populates it from the Shape file. This is the default mode.
+
+.TP 
+\fB\-D\fR
+Creates a new table and populates it from the Shape file. This uses the PostgreSQL "dump" format for the output data and is much faster to load than the default "insert" SQL format. Use this for very large data sets.
+
+.TP 
+\fB\-s\fR <\fISRID\fR>
+Creates and populates the geometry tables with the specified SRID.
+
+.TP 
+\fB\-k\fR
+Keep idendifiers case (column, schema and attributes). Note that attributes in Shapefile are all UPPERCASE.
+
+
+.TP 
+\fB\-i\fR
+Coerce all integers to standard 32\-bit integers, do not create 64\-bit bigints, even if the DBF header signature appears to warrant it.
+.SH "EXAMPLES"
+.LP 
+An example session using the loader to create an input file and uploading it might look like this:
+
+# \fBshp2pgsql shaperoads roadstable roadsdb > roads.sql\fR
+.br 
+# \fBpsql \-d roadsdb \-f roads.sql\fR
+
+A conversion and upload can be done all in one step using UNIX pipes:
+
+# \fBshp2pgsql shaperoads roadstable roadsdb | psql \-d roadsdb\fR
+.SH "AUTHORS"
+.LP
+Originally written by Jeff Lounsbury <jeffloun@refractions.net>.
+Improved and maintained by Sandro Santilli <strk@refractions.net>.
+
+This application uses functionality from shapelib 1.2.9
+by Frank Warmerdam <warmerda@gdal.velocet.ca> to read from ESRI Shape files.
+.SH "SEE ALSO"
+.LP 
+pgsql2shp(1)