[postgis-tickets] [SCM] PostGIS branch master updated. 3.3.0alpha1-7-g6e0680a6e

[git at osgeo.org]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "PostGIS".

The branch, master has been updated
       via  6e0680a6ec2ba5959d0566b655fa433173a40b83 (commit)
      from  c8abe00120a7669dc7cda5ff1bb4f1964dc3bb01 (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit 6e0680a6ec2ba5959d0566b655fa433173a40b83
Author: Sandro Santilli <strk at kbt.io>
Date:   Mon May 23 10:29:37 2022 +0200

    Add manpages for pgtopo_import and pgtopo_export
    
    Closes #5158

diff --git a/doc/Makefile.in b/doc/Makefile.in
index e02f5f459..0a0f29531 100644
--- a/doc/Makefile.in
+++ b/doc/Makefile.in
@@ -395,10 +395,14 @@ man-install: man/shp2pgsql.1 man/pgsql2shp.1
 	mkdir -p $(DESTDIR)$(PGSQL_MANDIR)/man1
 	$(INSTALL_DATA) man/pgsql2shp.1 $(DESTDIR)$(PGSQL_MANDIR)/man1/pgsql2shp.1
 	$(INSTALL_DATA) man/shp2pgsql.1 $(DESTDIR)$(PGSQL_MANDIR)/man1/shp2pgsql.1
+	$(INSTALL_DATA) man/pgtopo_export.1 $(DESTDIR)$(PGSQL_MANDIR)/man1/pgtopo_export.1
+	$(INSTALL_DATA) man/pgtopo_import.1 $(DESTDIR)$(PGSQL_MANDIR)/man1/pgtopo_import.1
 
 man-uninstall:
 	rm -f $(DESTDIR)$(PGSQL_MANDIR)/man1/shp2pgsql.1
 	rm -f $(DESTDIR)$(PGSQL_MANDIR)/man1/pgsql2shp.1
+	rm -f $(DESTDIR)$(PGSQL_MANDIR)/man1/pgtopo_export.1
+	rm -f $(DESTDIR)$(PGSQL_MANDIR)/man1/pgtopo_import.1
 
 docs-install: html/postgis.html html/style.css
 	mkdir -p $(DESTDIR)$(PGSQL_DOCDIR)/postgis/images
diff --git a/doc/man/pgtopo_export.1 b/doc/man/pgtopo_export.1
new file mode 100644
index 000000000..28c494545
--- /dev/null
+++ b/doc/man/pgtopo_export.1
@@ -0,0 +1,49 @@
+.TH "pgtopo_export" "1" "" "" "PostGIS"
+.SH "NAME"
+.LP
+pgtopo_export - postgis topology exporter
+
+.SH "SYNTAX"
+.LP
+pgtopo_export [\fIoptions\fR] \fIdatabase\fR \fItopology\fR
+
+.SH "DESCRIPTION"
+.LP
+The pgtopo_export script connects to the named database and exports
+data of the named topology and associated layers to a file with a
+custom format.
+
+.SH "USAGE"
+.LP
+The <database> is the name of the database to connect to.
+
+The <topology> is the name of the topology to read data from.
+
+.SH "OPTIONS"
+.LP
+The commandline options are:
+.TP
+\fB\-f\fR <\fIfilename\fR>
+Write the output to a particular filename instead of stadard output.
+.TP
+\fB\--skip-layers\fR
+Do not export layers, just topology primitives.
+\fB\-h\fR
+Display usage information.
+
+.SH "EXAMPLES"
+.LP
+An example session using the exporter to create an export file of a
+topology "city_data" from a database might look like this:
+
+# \fBpgtopo_export \-f city_data.pgtopo_export my_db city_data\fR
+
+.SH "AUTHORS"
+.LP
+Originally written by Sandro Santilli <strk at kbt.io>.
+
+.SH "SEE ALSO"
+.LP
+pgtopo_import(1)
+
+More information is available at http://postgis.net
diff --git a/doc/man/pgtopo_import.1 b/doc/man/pgtopo_import.1
new file mode 100644
index 000000000..8d4683c7a
--- /dev/null
+++ b/doc/man/pgtopo_import.1
@@ -0,0 +1,60 @@
+.TH "pgtopo_import" "1" "" "" "PostGIS"
+.SH "NAME"
+.LP
+pgtopo_import - postgis topology importer
+
+.SH "SYNTAX"
+.LP
+pgtopo_import [ --skip-layers | --only-layers ] [ -f <dumpfile> ] <toponame>
+pgtopo_import [\fIoptions\fR] \fItopology\fR
+
+.SH "DESCRIPTION"
+.LP
+The pgtopo_import data loader reads an export file written
+by pgtopo_export and outputs an SQL script reconstructing
+the topology therein contained.
+
+.SH "USAGE"
+.LP
+The <topology> is the name to give to the re-created topology, which
+can be different from the name of the topology the export was made
+from.
+
+By default the SQL script is written on standard output.
+
+.SH "OPTIONS"
+.LP
+These are the supported options
+
+(Note that \--skip-layers and \--only-layers are mutually exclusive.)
+.TP
+\fB\--skip-layers\fR
+Do not include layers in the output SQL script. Just the topology
+schema.
+.TP
+\fB\--only-layers\fR
+Do not include the topology schema in the output SQL script. Just the
+layers.
+.TP
+\fB\-f\fR <\fIfilename\fR>
+Read the export file from the specified filename, rather than from
+standard input.
+\fB\-h\fR
+Display usage information.
+
+.SH "EXAMPLES"
+.LP
+An example session using the loader to create an SQL file and uploading it
+might look like this:
+
+# \fBpgtopo_import city_data < city_data.pgtopo_export | psql newdb\fR
+
+.SH "AUTHORS"
+.LP
+Originally written by Sandro Santilli <strk at kbt.io>.
+
+.SH "SEE ALSO"
+.LP
+pgtopo_export(1)
+
+More information is available at http://postgis.net

-----------------------------------------------------------------------

Summary of changes:
 doc/Makefile.in         |  4 ++++
 doc/man/pgtopo_export.1 | 49 ++++++++++++++++++++++++++++++++++++++++
 doc/man/pgtopo_import.1 | 60 +++++++++++++++++++++++++++++++++++++++++++++++++
 3 files changed, 113 insertions(+)
 create mode 100644 doc/man/pgtopo_export.1
 create mode 100644 doc/man/pgtopo_import.1


hooks/post-receive
-- 
PostGIS