.TH "OSMCOASTLINE_SEGMENTS" "1" "2.2.4" "" ""
.SH NAME
.PP
osmcoastline_segments \- analyze OpenStreetMap coastline changes from
segment files
.SH SYNOPSIS
.PP
\f[B]osmcoastline_segments\f[] [\f[I]OPTIONS\f[]]
\f[I]SEGMENT\-FILE1\f[] \f[I]SEGMENT\-FILE2\f[]
.SH DESCRIPTION
.PP
The \f[B]osmcoastline\f[] program can write out all segments of the
coastline into a file (when started with the \f[B]\-S,
\-\-write\-segments=FILE\f[] option).
This program can be used to compare two of those segment files in
various ways to detect coastline changes between different runs of the
\f[B]osmcoastline\f[] program.
.SH OPTIONS
.TP
.B \-h, \-\-help
Display usage information.
.RS
.RE
.TP
.B \-d, \-\-dump
Dump segment list to stdout in plain text format.
.RS
.RE
.TP
.B \-g, \-\-geom=FILENAME
Write segments to geometry file or database using OGR.
.RS
.RE
.TP
.B \-f, \-\-format=FORMAT
OGR format for writing out geometries.
.RS
.RE
.TP
.B \-V, \-\-version
Display program version and license information.
.RS
.RE
.SH DIAGNOSTICS
.PP
\f[B]osmcoastline_segments\f[] exits with exit code
.TP
.B 0
if the segment files are the same
.RS
.RE
.TP
.B 1
if the segment files are different
.RS
.RE
.TP
.B 3
if there was a fatal error when running the program
.RS
.RE
.TP
.B 4
if there was a problem with the command line arguments.
.RS
.RE
.SH EXAMPLES
.PP
Just return 0 or 1 depending on whether the segments are the same in
both files:
.IP
.nf
\f[C]
osmcoastline_segments\ old.segments\ new.segments
\f[]
.fi
.PP
Dump the list of removed and added segments to stdout:
.IP
.nf
\f[C]
osmcoastline_segments\ \-\-dump\ old.segments\ new.segments
\f[]
.fi
.PP
Create a shapefile with the differences:
.IP
.nf
\f[C]
osmcoastline_segments\ \-\-geom=diff.shp\ old.segments\ new.segments
\f[]
.fi
.SH SEE ALSO
.IP \[bu] 2
\f[C]README.md\f[]
.IP \[bu] 2
\f[B]osmcoastline\f[](1)
.IP \[bu] 2
Project page (https://osmcode.org/osmcoastline/)
.IP \[bu] 2
OSMCoastline in OSM
wiki (https://wiki.openstreetmap.org/wiki/OSMCoastline)
.SH COPYRIGHT
.PP
Copyright (C) 2012\-2019 Jochen Topf <jochen@topf.org>.
License GPLv3+: GNU GPL version 3 or later
<https://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH CONTACT
.PP
If you have any questions or want to report a bug, please go to
https://osmcode.org/contact.html
.SH AUTHORS
Jochen Topf <jochen@topf.org>.