[shapelib] 21/22: Add manpage for shputils.

[Bas Couwenberg]

This is an automated email from the git hooks/post-receive script.

sebastic pushed a commit to branch master
in repository shapelib.

commit f1fd1ae9c024068176ce01ca86b7f0e4a5df8fd2
Author: Bas Couwenberg <sebastic at xs4all.nl>
Date:   Tue Dec 6 21:37:12 2016 +0100

    Add manpage for shputils.
---
 debian/changelog       |  1 +
 debian/man/shputils.md | 73 ++++++++++++++++++++++++++++++++++++++++++++++++++
 2 files changed, 74 insertions(+)

diff --git a/debian/changelog b/debian/changelog
index 2944315..e0e61d3 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -16,6 +16,7 @@ shapelib (1.4.0~rc1-1) UNRELEASED; urgency=medium
   * Explicitly remove .la files.
   * Drop obsolete build system patches.
   * Use dh_auto_* tools instead of custom commands.
+  * Add manpage for shputils.
 
  -- Bas Couwenberg <sebastic at debian.org>  Tue, 06 Dec 2016 19:46:29 +0100
 
diff --git a/debian/man/shputils.md b/debian/man/shputils.md
new file mode 100644
index 0000000..aa10076
--- /dev/null
+++ b/debian/man/shputils.md
@@ -0,0 +1,73 @@
+shputils(1) -- shapefile utility
+================================
+
+##SYNOPSIS
+`shputils` _in_shp_file_ _out_shp_file_ _args_
+
+##DESCRIPTION
+The program will append to an existing shape file or it will
+create a new file if needed.
+Only the items in the first output file will be preserved.
+When an item does not match with the append theme then the item
+might be placed to an existing item at the same position and type.
+
+OTHER FUNCTIONS:
+
+- Describe all items in the dbase file (Use ALL for more than 5000 recs.)
+
+- Select a group of shapes from a comma separated selection list.
+
+- UnSelect a group of shapes from a comma separated selection list.
+
+- Clip boundary extent or by theme boundary.
+    Touch writes all the shapes that touch the boundary.
+    Inside writes all the shapes that are completely within the boundary.
+    Boundary clips are only the min and max of a theme boundary.
+
+- Erase boundary extent or by theme boundary.
+    Erase is the direct opposite of the Clip function.
+
+- Change coordinate value units between meters and feet.
+    There is no way to determine the input unit of a shape file.
+    Skip this function if the shape file is already in the correct unit.
+    Clip and Erase will be done before the unit is changed.
+    A shift will be done after the unit is changed.
+
+- Shift X and Y coordinates.
+
+Finally,
+
+There can only be one select or unselect in the command line.
+
+There can only be one clip or erase in the command line.
+There can only be one unit and only one shift in the command line.
+
+Examples:
+
+ shputils in.shp out.shp   SELECT countycode 3,5,9,13,17,27
+
+ shputils in.shp out.shp   CLIP   10 10 90 90 Touch   FACTOR Meter Feet
+
+ shputils in.shp out.shp   FACTOR Meter 3.0
+
+ shputils in.shp out.shp   CLIP   clip.shp Boundary Touch   SHIFT 40 40
+
+  shputils in.shp out.shp   SELECT co 112   CLIP clip.shp Boundary Touch
+
+USAGE: shputils  <DescribeShape>   {ALL}
+
+USAGE: shputils  <InputShape>  <OutShape|AppendShape>
+
+   { <FACTOR>       <FEET|MILES|METERS|KM> <FEET|MILES|METERS|KM|factor> }
+
+   { <SHIFT>        <xshift> <yshift> }
+
+   { <SELECT|UNSEL> <Item> <valuelist> }
+
+   { <CLIP|ERASE>   <xmin> <ymin> <xmax> <ymax> <TOUCH|INSIDE|CUT> }
+
+   { <CLIP|ERASE>   <theme>      <BOUNDARY>     <TOUCH|INSIDE|CUT> }
+
+Note: CUT is not complete and does not create intersections.
+     For more information read programmer comment.
+

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-grass/shapelib.git