debian man page for shpadd

SHAPELIB(1)							   User Commands						       SHAPELIB(1)

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)

shapelib							   OCTOBER 2004 						       SHAPELIB(1)