.\" Process this file with
.\" groff -man -Tascii shpadd.1
.\"
.TH SHAPELIB 1 "OCTOBER 2004" "shapelib" "User Commands"
.SH NAME
shpadd \- append a shape to an ESRI shapefile
.SH SYNOPSIS
.B shpadd
.I file
.RI "[[" "x y" "] [+]]*"
.SH DESCRIPTION
Appends a shape to the shapefile determined from
.IR file .
The geometric data of the new shape consists of lists of 
.I X/Y 
points on the command line grouped into 
.IR parts ,
with points in different parts separated by a plus
.RB ( + )
sign.  If no points or parts are given then a shape of type
.B NullShape
is appended to the shapefile, and otherwise the type of the new shape
is determined by the shapefile's header.  See
.BR shpdump (1)
for a description of shape types and how geometric data for parts are
interpreted for a specific type.  No geometric restrictions set by the
shapefile specification are enforced by
.BR shpadd (1).

Shapefiles actually consist of two files with the same basename and
extensions
.BR .shp \ and\  .shx " (or " .SHP \ and\  .SHX ") "
containing the shape data and shape index respectively.  The files
to open are determined by first stripping any filename extension
from
.I file 
and attempting to open the files
.IB file .shp
or 
.IB file .SHP,
and
.IB file .shx
or
.IB file .SHX
for the respective data and index files.

.SH EXIT STATUS
.TP
.B 0
Successful program execution.
.TP
.B 1
Missing
.I file
argument, the shapefile can't be opened, or the program
ran out of memory.
.SH DIAGNOSTICS
The following diagnostics may be issued on stdout:
.TP
.RI "Unable to open:" file
.TP
.RI "Out of memory"
.SH AUTHORS
Frank Warmerdam (warmerdam@pobox.com) is the maintainer of the
.B shapelib
shapefile library.  Joonas Pihlaja (jpihlaja@cc.helsinki.fi) wrote
this man page.
.SH BUGS
Coordinate values that can't be
be parsed by 
.BR sscanf (3)
get undefined values.  There's no way to give measure or
.I Z
data to vertices in a shape, but those are always set to zero
if the shapefile's shape type requires those values.
.B MultiPatch
shape types aren't supported.
.SH "SEE ALSO"
.BR dbfadd (1),
.BR dbfcreate (1),
.BR dbfdump (1),
.BR dbf_dump (1),
.BR shpcreate (1),
.BR shpdump (1),
.BR shprewind (1)