RubyGems - shp - Versions diffs - 0.0.1 - Mend

shp 0.0.1

Files changed (78) hide show

checksums.yaml +15 -0
data/.gitignore +34 -0
data/.travis.yml +4 -0
data/Gemfile +3 -0
data/LICENSE +28 -0
data/README.md +30 -0
data/Rakefile +23 -0
data/ext/shp/base.hpp +113 -0
data/ext/shp/dbf.cpp +381 -0
data/ext/shp/dbf.hpp +44 -0
data/ext/shp/extconf.rb +13 -0
data/ext/shp/shape_object.cpp +58 -0
data/ext/shp/shape_object.hpp +27 -0
data/ext/shp/shapefile.cpp +299 -0
data/ext/shp/shapefile.hpp +35 -0
data/ext/shp/shapelib/.cvsignore +15 -0
data/ext/shp/shapelib/ChangeLog +450 -0
data/ext/shp/shapelib/HOWTO-RELEASE +16 -0
data/ext/shp/shapelib/LICENSE.LGPL +483 -0
data/ext/shp/shapelib/Makefile +113 -0
data/ext/shp/shapelib/README +41 -0
data/ext/shp/shapelib/README.tree +172 -0
data/ext/shp/shapelib/contrib/.cvsignore +12 -0
data/ext/shp/shapelib/contrib/Makefile +66 -0
data/ext/shp/shapelib/contrib/ShapeFileII.pas +234 -0
data/ext/shp/shapelib/contrib/Shape_PointInPoly.cpp +238 -0
data/ext/shp/shapelib/contrib/Shape_PointInPoly_README.txt +59 -0
data/ext/shp/shapelib/contrib/csv2shp.c +558 -0
data/ext/shp/shapelib/contrib/dbfcat.c +166 -0
data/ext/shp/shapelib/contrib/dbfinfo.c +106 -0
data/ext/shp/shapelib/contrib/makefile.vc +34 -0
data/ext/shp/shapelib/contrib/my_nan.h +46 -0
data/ext/shp/shapelib/contrib/shpcat.c +100 -0
data/ext/shp/shapelib/contrib/shpcentrd.c +159 -0
data/ext/shp/shapelib/contrib/shpdata.c +129 -0
data/ext/shp/shapelib/contrib/shpdxf.c +340 -0
data/ext/shp/shapelib/contrib/shpfix.c +110 -0
data/ext/shp/shapelib/contrib/shpgeo.c +1595 -0
data/ext/shp/shapelib/contrib/shpgeo.h +154 -0
data/ext/shp/shapelib/contrib/shpinfo.c +113 -0
data/ext/shp/shapelib/contrib/shpproj.c +260 -0
data/ext/shp/shapelib/contrib/shpsort.c +605 -0
data/ext/shp/shapelib/contrib/shpsort.txt +44 -0
data/ext/shp/shapelib/contrib/shpwkb.c +123 -0
data/ext/shp/shapelib/contrib/tests/shpproj.sh +38 -0
data/ext/shp/shapelib/dbfopen.c +2221 -0
data/ext/shp/shapelib/makefile.vc +86 -0
data/ext/shp/shapelib/makeshape.sh +21 -0
data/ext/shp/shapelib/mkdist.sh +37 -0
data/ext/shp/shapelib/mkinstalldirs +38 -0
data/ext/shp/shapelib/mkrelease.sh +55 -0
data/ext/shp/shapelib/safileio.c +286 -0
data/ext/shp/shapelib/shapefil.h +647 -0
data/ext/shp/shapelib/shapelib.def +46 -0
data/ext/shp/shapelib/shpopen.c +2388 -0
data/ext/shp/shapelib/shptree.c +1187 -0
data/ext/shp/shapelib/shputils.c +1072 -0
data/ext/shp/shapelib/stream1.out +1465 -0
data/ext/shp/shapelib/stream1.sh +28 -0
data/ext/shp/shapelib/stream2.out +530 -0
data/ext/shp/shapelib/stream2.sh +11 -0
data/ext/shp/shapelib/stream3.out +37 -0
data/ext/shp/shapelib/web/.cvsignore +2 -0
data/ext/shp/shapelib/web/codepage.html +403 -0
data/ext/shp/shapelib/web/dbf_api.html +436 -0
data/ext/shp/shapelib/web/index.html +235 -0
data/ext/shp/shapelib/web/license.html +78 -0
data/ext/shp/shapelib/web/manifest.html +87 -0
data/ext/shp/shapelib/web/release.html +80 -0
data/ext/shp/shapelib/web/shapelib-tools.html +352 -0
data/ext/shp/shapelib/web/shp_api.html +376 -0
data/ext/shp/shp.cpp +19 -0
data/ext/shp/shp.hpp +47 -0
data/lib/shp.rb +35 -0
data/lib/shp/version.rb +3 -0
data/shp.gemspec +23 -0
data/spec/shp_spec.rb +127 -0
metadata +176 -0

data/ext/shp/shapelib/web/license.html ADDED Viewed

@@ -0,0 +1,78 @@
+<html>
+<head>
+<title>Shapelib License</title>
+<link href="http://www.maptools.org/maptools.css" rel="stylesheet" type="text/css">
+</head>
+<body>
+<h1>License</h1>
+The source for the Shapefile C Library is (c) 1998 Frank Warmerdam,
+and released under the following conditions.  The intent is that anyone
+can do anything with the code, but that I do not assume any liability, nor
+express any warranty for this code.  <p>
+As of Shapelib 1.2.6 the core portions of the library are made available
+under two possible licenses.  The licensee can choose to use the code
+under either the Library GNU Public License (LGPL) described in
+LICENSE.LGPL or under the following MIT style license.  Any files in
+the Shapelib distribution without explicit copyright license terms
+(such as this documentation, the Makefile and so forth) should be
+considered to have the following licensing terms.  Some auxilary portions
+of Shapelib, notably some of the components in the contrib directory
+come under slightly different license restrictions.  Check the source
+files that you are actually using for conditions.<p>
+<h3>Default License Terms</h3>
+<quote>
+Copyright (c) 1999, Frank Warmerdam<p>
+This software is available under the following "MIT Style" license,
+or at the option of the licensee under the LGPL (see LICENSE.LGPL).  This
+option is discussed in more detail in shapelib.html.<p>
+Permission is hereby granted, free of charge, to any person obtaining a
+copy of this software and associated documentation files (the "Software"),
+to deal in the Software without restriction, including without limitation
+the rights to use, copy, modify, merge, publish, distribute, sublicense,
+and/or sell copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following conditions:<p>
+The above copyright notice and this permission notice shall be included
+in all copies or substantial portions of the Software.<p>
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.<p>
+</quote>
+<h3>Shapelib Modifications</h3>
+I am pleased to receive bug fixes, and improvements for Shapelib.  Unless
+the submissions indicate otherwise I will assume that changes submitted to
+me remain under the the above "dual license" terms.  If changes are made
+to the library with the intention that those changes should be protected by
+the LGPL then I should be informed upon submission.  Note that I will not
+generally incorporate changes into the core of Shapelib that are protected
+under the LGPL as this would effectively limit the whole file and
+distribution to LGPL terms.<p>
+<h3>Opting for LGPL</h3>
+For licensee's opting to use Shapelib under LGPL as opposed to the MIT
+Style license above, and wishing to redistribute the software based on
+Shapelib, I would ask that all "dual license" modules be updated to
+indicate that only the LGPL (and not the MIT Style license) applies.  This
+action represents opting for the LGPL, and thereafter LGPL terms apply to
+any redistribution and modification of the affected modules.<p>
+</body>
+</html>

data/ext/shp/shapelib/web/manifest.html ADDED Viewed

@@ -0,0 +1,87 @@
+<html>
+<head>
+<title>Shapefile C Library V1.2</title>
+<link href="http://www.maptools.org/maptools.css" rel="stylesheet" type="text/css">
+</head>
+<body>
+<h1>Shapelib Manifest</h1>
+<ul>
+<li> <b>web/index.html</b>: This file - general documentation on the
+Shapefile C Library.<p>
+<li> <b><a href="shp_api.html">web/shp_api.html</a></b>: Documentation
+for the API for accessing the .shp/.shx files. <p>
+<li> <b><a href="dbf_api.html">web/dbf_api.html</a></b>: Documentation
+for the API for accessing the .dbf attribute files. <p>
+<li> <b>shpopen.c</b>: C code for access to .shp/.shx vertex files.<p>
+<li> <b>dbfopen.c</b>: C code for access to .dbf attribute file.<p>
+<li> <b>shapefil.h</b>:  Include file defining all the services of dbfopen.c
+and shpopen.c.<p>
+<li> <b>contrib/</b>: A directory of "in progress" contributed programs
+from Carl Anderson.<p>
+<li> <b>dbfcreate.c</b>: Simple example program for creating a new .dbf file.
+     <p>
+<li> <b>dbfadd.c</b>:
+	Simple example program for adding a record to a .dbf file.<p>
+<li> <b>dbfdump.c</b>: Simple example program for displaying the contents of
+		  a .dbf file.<p>
+<li> <b>shpcreate.c</b>: Simple example program for creating a new .shp and
+.shx file.<p>
+<li> <b>shpadd.c</b>: Simple example program for adding a shape to an existing
+		  shape file.<p>
+<li> <b>shpdump.c</b>: Simple program for dumping all the vertices in a
+		shapefile with an indicating of the parts.<p>
+<li> <b>shputils.c</b>: Complex contributed program capable of clipping and
+		  appending
+                  shapefiles as well as a few other things.  Type shputils
+                  after building to get a full usage message.<p>
+<li> <b>Makefile</b>: A simple makefile to compile the library and example
+		  programs.<p>
+<li> <b>makeshape.sh</b>: A simple script for running some of the example
+programs.<p>
+<li> <b>shptest.c</b>: A simple test harnass to generate each of the supported
+		  types of shapefiles. <p>
+<li> <b>shptree.c</b>: Implements a simple quadtree algorithm for fast
+spatial searches of shapefiles.<p>
+<li> <b>shptreedump.c</b>: A simple mainly showing information on quad
+trees build using the quad tree api.<p>
+<li> <b>stream1.sh</b> - A test script, which should produce stream1.out.
+Note this will only work if you have the example data downloaded.<p>
+<li> <b>stream1.out</b>: Expected output of stream1.sh test script.<p>
+<li> <b>stream2.sh</b>: A test script, which should produce stream2.out.<p>
+<li> <b>stream2.out</b>: Expected output of stream2.sh test script.<p>
+<li> <b>pyshapelib-0.1</b>: Prototype contributed Python bindings.<p>
+</ul>
+</body>
+</html>

data/ext/shp/shapelib/web/release.html ADDED Viewed

@@ -0,0 +1,80 @@
+<html>
+<head>
+<title>Shapelib Release Notes</title>
+<link href="http://www.maptools.org/maptools.css" rel="stylesheet" type="text/css">
+</head>
+<body>
+<h1>Shapelib Release Notes</h1>
+To get notification of new releases of Shapelib <i>subscribe</i> to
+the project at www.freshmeat.net.  This is currently the only reliable
+way of finding out about new releases since there is no shapelib specific
+mailing list.<p>
+<b>Release 1.3.0</b>:
+<ul>
+<li> Major rework to us application provided hooks for file io, and error reporting (SAHooks).
+<li> Added contrib/Shape_PointInPoly.cpp from Marko Podgorsek.
+<li> Added shapelib tools documentation from Eduardo Patto Kanegae.
+<li> Added dbf deletion support.
+<li> Added DBFAddNativeFieldType().
+<li> Added DBFDeleteField(), DBFReorderFields() and DBFAlterFields() to
+rework DBF schema.
+<li> likely a variety of other changes - it has been eight years since 1.2.10!
+</ul>
+<b>Release 1.2.10</b>: Added SHPRewindObject() function, and shprewind utility
+program.  Added FTLogical, DBFReadLogicalAttribute() and
+DBFWriteLogicalAttribute() (thanks to Olek Neyman). <p>
+<b>Release 1.2.9</b>: Good support for reading and writing NULL fields
+in .dbf files, good support for NULL shapes and addition of the
+DBFGetFieldIndex() functions (all contributed by Jim Matthews).<p>
+An upgraded shputils.c has been contributed by Bill Miller.  Daniel
+Morissette contributed DBFGetNativeFieldType().  Better error checking
+for disk errors in dbfopen.c.  Various other bug fixes and safety improvements.
+<p>
+<b>Release 1.2.8</b>: Added hacked libtool support (supplied by Jan)
+and "rpm ready" install logic.<p>
+<b>Release 1.2.7</b>: Fix record size (was 4 bytes too long).  Modify
+SHPReadObject() to handle null shapes properly.  Use atof() instead of
+sscanf().  Support .DBF as well as .dbf.<p>
+<b>Release 1.2.6</b>: Now available under old MIT style license, or at the
+users option, LGPL.  Added the contrib directory of stuff from Carl Anderson
+and the shptree.c API for quadtree based spatial searches.<p>
+<b>Release 1.2.5</b>: SHPOpen() now forcably uses "rb" or "r+b" access string
+to avoid common mistakes on Windows.  Also fixed a serious bug with .dbf
+files with a 'F' field type.<p>
+<b>Release 1.2.4</b>: DBFOpen() will now automatically translate a .shp
+extension to .dbf for convenience.  SHPOpen() will try datasets with lower
+and uppercase extension.  DBFAddField() now returns the field number,
+not TRUE/FALSE.<p>
+<b>Release 1.2.3</b>: Disable writing measures to multi-patches as ArcView
+seems to puke on them (as reported by Monika Sester).  Add white space
+trimming, and string/numeric attribute interchangability in DBF API
+as suggested by Steve Lime.  Dbfdump was updated to include several
+reporting options.<p>
+<b>Release 1.2.2</b>: Added proper support for multipatch (reading and
+writing) - this release just for testing purposes.<p>
+<b>Release 1.2</b> is mostly a rewrite of the .shp/.shx access API to account
+for ArcView 3.x 3D shapes, and to encapsulate the shapes in a structure.
+Existing code using the shapefile library will require substantial changes
+to use release 1.2.<p>
+<b>Release V1.1</b> has been built on a number of platforms, and used by a
+number of people successfully.  V1.1 is the first release with the xBase API
+documentation.<p>
+</body>
+</html>

data/ext/shp/shapelib/web/shapelib-tools.html ADDED Viewed

@@ -0,0 +1,352 @@
+<html>
+<head>
+<title>ShapeLib Tools - User Guide</title>
+<link href="http://www.maptools.org/maptools.css" rel="stylesheet" type="text/css">
+</head>
+<body>
+<h1>ShapeLib Tools - User Guide</h1>
+ShapeLib is maintained by Frank Warmerdam<br>
+This guide was created by <a href="http://www.consultoria.eti.br" target="_show">Eduardo Patto Kanegae</a> &lt;&nbsp;eduardo<i>~at~</i>consultoria<i>~dot~</i>eti<i>~dot~</i>br&nbsp;&gt;
+<ul>
+	<li><a href="#dbfcreate">dbfcreate</a></li>
+	<li><a href="#dbfadd">dbfadd</a></li>
+	<li><a href="#dbfdump">dbfdump</a></li>
+	<li><a href="#shpcreate">shpcreate</a></li>
+	<li><a href="#shpadd">shpadd</a></li>
+	<li><a href="#shpdump">shpdump</a></li>
+	<li><a href="#shprewind">shprewind</a></li>
+	<li><i>Tools from ShapeLib 'contrib' directory</i>
+		<ul>
+			<li><a href="#dbfinfo">dbfinfo</a></li>
+			<li><a href="#dbfcat">dbfcat</a></li>
+			<li><a href="#shpinfo">shpinfo</a></li>
+			<li><a href="#shpcat">shpcat</a></li>
+			<li><a href="#shpcentrd">shpcentrd</a></li>
+			<li><a href="#shpdxf">shpdxf</a></li>
+			<li><a href="#shpfix">shpfix</a></li>
+			<li><a href="#shpproj">shpproj</a></li>
+		</ul>
+	</li>
+</ul>
+<h2><a name="dbfcreate">dbfcreate</a></h2>
+<b>Purpose</b>: creates a new and empty .dbf file.
+<br>
+<b>Usage</b>: <font face="courier">dbfcreate xbase_file [[-s field_name width],[-n field_name width decimals]]...</font>
+<br>
+<ul>
+	<li><b>xbase_file</b>: the name of xBase file to be created. Doesn't need the extension.</li>
+	<li><b>-s field_name width</b>: creates a string field with name <u>field_name</u> and size <u>width</u>.</li>
+	<li><b>-n field_name width decimals</b>: creates a numeric field with name <u>field_name</u>, width of <u>width</u> and with decimals places sized by <u>decimals</u>.</li>
+</ul>
+<b>Example</b>
+<br>
+<font face="courier">$ dbfcreate testbase -s NAME 20, -n AREA 9 3, -n VALUE 9 2</font>
+<br># this will create a file named testbase.dbf with 3 fields: NAME ( string (20)),
+AREA ( float (9,3)) and VALUE ( float (9,2))
+<br>
+<hr>
+<h2><a name="dbfadd">dbfadd</a></h2>
+<b>Purpose</b>: adds a record into an existing .dbf file.
+<br>
+<b>Usage</b>: <font face="courier">dbfadd xbase_file field_values</font>
+<br>
+<ul>
+	<li><b>xbase_file</b>: the name of an existing xBase file.</li>
+	<li><b>field_values</b>: list of values to be inserted into the xBase file.
+	You must specify a number of values equal to the number of fields the xBase file has.
+	The order of values must also reflect the order of fields inside xBase file.</li>
+</ul>
+<b>Example</b>
+<br>
+<font face="courier">$ dbfadd testbase.dbf REGION1 25.656 150.22</font>
+<br># assuming that testbase.dbf has 3 fields( NAME, AREA and VALUE), this command line
+will insert a new record into testbase.dbf with the value "REGION1" for NAME,
+'25.656' for AREA and '150.22' for VALUE field.
+<br>
+<hr>
+<h2><a name="dbfdump">dbfdump</a></h2>
+<b>Purpose</b>: dumps the content of a xBase file to the terminal.
+<br>
+<b>Usage</b>: <font face="courier">dbfdump [-h] [-r] [-m] xbase_file</font>
+<br>
+<ul>
+	<li><b>-h</b>: output header info( field descriptions).</li>
+	<li><b>-r</b>: output raw field info, numeric values not reformatted.</li>
+	<li><b>-m</b>: output one line per field.</li>
+	<li><b>xbase_file</b>: the name of an existing xBase file.</li>
+</ul>
+<b>Example</b>
+<br>
+<font face="courier">$ dbfdump -h testbase.dbf</font>
+<br># assuming that testbase.dbf has 1 record( inserted by previous example using 'dbfadd'),
+this command line will produce the following output:<br>
+<font face="courier">
+Field 0: Type=String, Title=`NAME', Width=20, Decimals=0<br>
+Field 1: Type=Double, Title=`AREA', Width=9, Decimals=3<br>
+Field 2: Type=Double, Title=`VALUE', Width=9, Decimals=2<br>
+NAME                      AREA     VALUE<br>
+REGION1                 25.656    150.22
+</font>
+<br>
+<hr>
+<h2><a name="shpcreate">shpcreate</a></h2>
+<b>Purpose</b>: creates a new and empty shapefile.
+<br>
+<b>Usage</b>: <font face="courier">shpcreate shp_file [point|arc|polygon|multipoint]</font>
+<br>
+<ul>
+	<li><b>shp_file</b>: the name of shapefile to be created. Doesn't need the extension.</li>
+	<li><b>point/arc/polygon/multipoint</b>: the type of shapefile that you wish to create. You must specify a valid option.</li>
+</ul>
+<b>Example</b>
+<br>
+<font face="courier">$ shpcreate testpolygon polygon</font>
+<br># this will create a point shapefile named testpolygon( in fact testpolygon.shp and testpolygon.shx will be created).
+<br>
+<hr>
+<h2><a name="shpadd">shpadd</a></h2>
+<b>Purpose</b>: adds a shape into an existing shapefile.
+<br>
+<b>Usage</b>: <font face="courier">shpadd shp_file [[x y] [+]]*</font>
+<br>
+<ul>
+	<li><b>shp_file</b>: the name of an existing shapefile.</li>
+	<li><b>x<sub><i>1</i></sub> y<sub><i>1</i></sub> x<sub><i>2</i></sub> y<sub><i>2</i></sub> ... x<sub><i>n</i></sub> y<sub><i>n</i></sub></b>: the set of x,y coordinates that describes the shape that you wish to add. Note that you must specify the correct number of parameters for a given type of shapefile. e.g.: for point shapefiles you have to pass 1 pair of XY coordinates and for a polygon shapefile you should pass at least 4 pairs of XY coordinates( where the first and the last point must have the same coordinates).</li>
+</ul>
+<b>Example</b>
+<br>
+<font face="courier">$ shpadd testpolygon 100000 7000000 250000 6500000 200000 6000000 100000 7000000</font>
+<br># assuming that testpolygon is a polygon shapefile, this command line will insert a new shape( a triangle) into testpolygon with the following XY coordinates:<br>
+vertice 0: 100000 7000000 ( this will also be the vertice where the shape starts and ends)<br>
+vertice 1: 250000 6500000<br>
+vertice 2: 200000 6000000<br>
+vertice 3: 100000 7000000<br>
+<hr>
+<h2><a name="shpdump">shpdump</a></h2>
+<b>Purpose</b>: dumps content of shapefile showing information like shape type, file extents, total of objects and vertices coordinates.
+<br>
+<b>Usage</b>: <font face="courier">shpdump [-validate] shp_file</font>
+<br>
+<ul>
+	<li><b>-validate</b>: count the number of objects that has invalid ring orderings.</li>
+	<li><b>shp_file</b>: the name of an existing shapefile.</li>
+</ul>
+<b>Example</b>
+<br>
+<font face="courier">$ shpdump testpolygon</font>
+<br># assuming that testpolygon is an existing shapefile previously created, this command line will output the following result:
+<pre>Shapefile Type: Polygon   # of Shapes: 1
+File Bounds: (  100000.000, 6000000.000,0,0)
+         to  (  250000.000, 7000000.000,0,0)
+Shape:0 (Polygon)  nVertices=4, nParts=1
+  Bounds:(  100000.000, 6000000.000, 0, 0)
+      to (  250000.000, 7000000.000, 0, 0)
+     (  100000.000, 7000000.000, 0, 0) Ring
+     (  250000.000, 6500000.000, 0, 0)
+     (  200000.000, 6000000.000, 0, 0)
+     (  100000.000, 7000000.000, 0, 0)</pre>
+<hr>
+<h2><a name="shprewind">shprewind</a></h2>
+<b>Purpose</b>: validates and resets the winding order of rings in polygon geometries to match the ordering required by shapefile specification. This is usefull for shapefiles having troubles when checked with a 'shpdump -validate'.
+<br>
+<b>Usage</b>: <font face="courier">shprewind in_shp_file out_shp_file</font>
+<br>
+<ul>
+	<li><b>in_shp_file</b>: the name of an existing shapefile.</li>
+	<li><b>out_shp_file</b>: the name of the new fixed shapefile that will be created.</li>
+</ul>
+<b>Example</b>
+<br>
+<font face="courier">$ shprewind badshapefile newshapefile</font>
+<br>
+<hr>
+<h2><a name="dbfinfo">dbfinfo</a></h2>
+<b>Purpose</b>: displays basic information for a given xBase file, like number of columns, number of records and type of each column.
+<br>
+<b>Usage</b>: <font face="courier">dbfinfo xbase_file</font>
+<br>
+<ul>
+	<li><b>xbase_file</b>: the name of an existing xBase file.</li>
+</ul>
+<b>Example</b>
+<br>
+<font face="courier">$ dbfinfo testbase</font>
+<br>
+<pre>Info for testbase.dbf
+3 Columns,  1 Records in file
+           NAME          string  (20,0)
+           AREA           float  (9,3)
+          VALUE           float  (9,2)
+</pre>
+<br>
+<hr>
+<h2><a name="dbfcat">dbfcat</a></h2>
+<b>Purpose</b>: appends the records of a source xBase file into a destiny xBase file. Both files must have the same number of fields.
+<br>
+<b>Usage</b>: <font face="courier">dbfcat [-v] [-f] from_DBFfile to_DBFfile</font>
+<br>
+<ul>
+	<li><b>-v</b>: verbose mode.</li>
+	<li><b>-f</b>: forces data convertion if data field types is not the same at both files or if is there any null value into <u>from_DBFfile</u>.</li>
+	<li><b>from_DBFfile</b>: source xBase file.</li>
+	<li><b>to_DBFfile</b>: destiny xBase file.</li>
+</ul>
+<b>Example</b>
+<br>
+<font face="courier">$ dbfcat -v testbase1 testbase2</font>
+<br>
+<hr>
+<h2><a name="shpinfo">shpinfo</a></h2>
+<b>Purpose</b>: displays basic information for a given shapefile, like shapefile type, number of objects and its extents.
+<br>
+<b>Usage</b>: <font face="courier">shpinfo shp_file</font>
+<br>
+<ul>
+	<li><b>shp_file</b>: the name of an existing shapefile.</li>
+</ul>
+<b>Example</b>
+<br>
+<font face="courier">$ shpinfo testpolygon</font>
+<br>
+<pre>Info for testpolygon
+Polygon(5), 1 Records in file
+File Bounds: (         100000,        6000000)
+        (         250000,        7000000)</pre>
+<hr>
+<h2><a name="shpcat">shpcat</a></h2>
+<b>Purpose</b>: appends the content of a source shapefile into a destiny shapefile. Both files must be the same shapefile type.
+<br>
+<b>Usage</b>: <font face="courier">shpcat from_shpfile to_shpfile</font>
+<br>
+<ul>
+	<li><b>from_shpfile</b>: source shapefile</li>
+	<li><b>to_shpfile</b>: destiny shapefile</li>
+</ul>
+<b>Example</b>
+<br>
+<font face="courier">$ shpcat shapefile1 shapefile2</font>
+<br>
+<hr>
+<h2><a name="shpcentrd">shpcentrd</a></h2>
+<b>Purpose</b>: computes XY centroid for polygon shapefiles.
+<br>
+<b>Usage</b>: <font face="courier">shpcentrd shp_file new_shp_file</font>
+<br>
+<ul>
+	<li><b>shp_file</b>: the name of an existing polygon shapefile.</li>
+	<li><b>new_shp_file</b>: the name of the point shapefile that will created.</li>
+</ul>
+<b>Example</b>
+<br>
+<font face="courier">$ shpcentrd apolygonfile pointcentrd</font>
+<br>
+<hr>
+<h2><a name="shpdxf">shpdxf</a></h2>
+<b>Purpose</b>: creates a DXF file from an existing shapefile.
+<br>
+<b>Usage</b>: <font face="courier">shpdxf shapefile {idfield}</font>
+<br>
+<ul>
+	<li><b>shapefile</b>: the name of an existing shapefile.</li>
+	<li><b>idfield</b>: explain</li>
+</ul>
+<b>Example</b>
+<br>
+<font face="courier">$ shpdxf testshapefile IDFIELD</font>
+<br># explain the command
+<br>
+<hr>
+<h2><a name="shpfix">shpfix</a></h2>
+<b>Purpose</b>: Utility program to fix nulls and inconsistencies in Shapefiles
+as happens from time to time.
+<br>
+<b>Usage</b>: <font face="courier">shpfix shpfile new_file &lt;Record# to Blank&gt;</font>
+<br>
+<ul>
+	<li><b>shpfile</b>: input file</li>
+	<li><b>new_file</b>: output file</li>
+</ul>
+<b>Example</b>
+<br>
+<font face="courier">$ shpfix broken fixed</font>
+<br>
+<hr>
+<h2><a name="shpproj">shpproj</a></h2>
+<b>Purpose</b>: Reproject Shapefiles using PROJ.4
+<br>
+<b>Usage</b>: <font face="courier">shpproj shp_file new_shp ( -i=in_proj_file | -i="in_params" | -i=geographic ) ( -o=out_info_file | -o="out_params" | -o=geographic ) </font>
+<br>
+<ul>
+	<li><b>param1</b>: explain</li>
+	<li><b>param2</b>: explain</li>
+</ul>
+<p>
+<b>INPUT</b><br>
+  Input can come from one of three sources.  A projection parameter file,
+  directly through parameters or geographic. If the shapefile has an associated
+  prj file, name the same as the shapefile but ending in ".prj" it will be used
+  by default ignoring all other parameters.  If input is omitted it defaults to
+  geographic, unless the default prj file exists.<p>
+<b>OUTPUT</b><br>
+  Output can come from one of three sources.  A projection parameter file,
+  directly through parameters or geographic.  If output is omitted it defaults
+  to geographic.<p>
+<b>PROJECTION PARAMETER FILE</b><br>
+  This file MUST end with the extension ".prj".  It has the form of one
+  projection parameter per line.  Parameters can be in any order.  The
+  projection parameters are those used to define a PROJ.4 projection.<p>
+<b>PROJECTION PARAMETERS</b><br>
+  Are the same as used by proj and invproj.<p>
+<pre>
+  use      proj -lP   to see available projections
+	   proj -lu   to see available units
+	   proj -le   to see available ellipsoid
+</pre>
+Or visit the PROJ.4 web page at <a href="http://www.remotesensing.org/proj">http://www.remotesensing.org/proj</a> for more details.<p>
+<p>
+<b>Example</b></br>
+the following example projects file rowtest to row3, moving data from Stateplane NAD83  zone 1002 to utm zone 16 in meters<p>
+<pre>
+shpproj rowtest row -i="init=nad83:1002 units=us-ft" -o="proj=utm zone=16 units=m"
+shpproj rowtest row3 -o="proj=utm zone=18 units=m" -i="zone=16 proj=utm units=us-ft"
+shpproj rowtest row3 -o="proj=utm zone=18 units=m"
+shpproj rowtest row3 -i=myfile.prj -o=geographic
+shpproj rowtest row3 -is=myfile.prj
+</pre>
+<hr>
+</body>
+</html>