NAME

       shpadd - append a shape to an ESRI shapefile

SYNOPSIS

       shpadd file [[x y] [+]]*

DESCRIPTION

       Appends  a  shape  to  the  shapefile determined from file.  The geometric data of the new
       shape consists of lists of X/Y points on the command line grouped into parts, with  points
       in  different  parts separated by a plus (+) sign.  If no points or parts are given then a
       shape of type NullShape is appended to the shapefile, and otherwise the type  of  the  new
       shape  is determined by the shapefile's header.  See 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 shpadd(1).

       Shapefiles   actually  consist  of  two  files  with  the  same  basename  and  extensions
       .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 file and
       attempting to open the files file.shp or  file.SHP,  and  file.shx  or  file.SHX  for  the
       respective data and index files.

EXIT STATUS

       0      Successful program execution.

       1      Missing  file  argument,  the  shapefile can't be opened, or the program ran out of
              memory.

DIAGNOSTICS

       The following diagnostics may be issued on stdout:

       Unable to open:file

       Out of memory

AUTHORS

       Frank Warmerdam (warmerdam@pobox.com) is the maintainer of the shapelib shapefile library.
       Joonas Pihlaja (jpihlaja@cc.helsinki.fi) wrote this man page.

BUGS

       Coordinate  values  that can't be be parsed by sscanf(3) get undefined values.  There's no
       way to give measure or Z data to vertices in a shape, but those are always set to zero  if
       the  shapefile's  shape  type  requires  those  values.   MultiPatch  shape  types  aren't
       supported.

SEE ALSO

       dbfadd(1), dbfcreate(1), dbfdump(1), dbf_dump(1), shpcreate(1), shpdump(1), shprewind(1)