The following commit has been merged in the master branch:
commit 22d57a660117dd84af88a3484171fa4089b1a94a
Author: Bas Couwenberg <sebas...@xs4all.nl>
Date:   Fri Jul 5 20:38:25 2013 +0200

    Add man page for sortshp.

diff --git a/debian/changelog b/debian/changelog
index cfe8431..3a375a0 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -27,6 +27,7 @@ mapserver (6.2.1-3) UNRELEASED; urgency=low
     - shptree
     - shptreetst
     - shptreevis
+    - sortshp
 
  -- Bas Couwenberg <sebas...@xs4all.nl>  Fri, 14 Jun 2013 22:00:07 +0200
 
diff --git a/debian/man/shptree.1.xml b/debian/man/shptree.1.xml
index 4556443..a1ab446 100644
--- a/debian/man/shptree.1.xml
+++ b/debian/man/shptree.1.xml
@@ -194,6 +194,11 @@ shptree us_states.shp
     <citerefentry>
       <refentrytitle>shptreevis</refentrytitle>
       <manvolnum>1</manvolnum>
+    </citerefentry>,
+
+    <citerefentry>
+      <refentrytitle>sortshp</refentrytitle>
+      <manvolnum>1</manvolnum>
     </citerefentry>
 
     <para>
diff --git a/debian/man/shptreetst.1.xml b/debian/man/shptreetst.1.xml
index 2a9988b..6cc0ed4 100644
--- a/debian/man/shptreetst.1.xml
+++ b/debian/man/shptreetst.1.xml
@@ -122,6 +122,11 @@ shptreetst esp 879827.480246 4317203.699447 884286.289767 
4321662.508967
     <citerefentry>
       <refentrytitle>shptreevis</refentrytitle>
       <manvolnum>1</manvolnum>
+    </citerefentry>,
+
+    <citerefentry>
+      <refentrytitle>sortshp</refentrytitle>
+      <manvolnum>1</manvolnum>
     </citerefentry>
   </refsect1>
 
diff --git a/debian/man/shptreevis.1.xml b/debian/man/shptreevis.1.xml
index 0ea961e..0f7ca9b 100644
--- a/debian/man/shptreevis.1.xml
+++ b/debian/man/shptreevis.1.xml
@@ -83,6 +83,11 @@ This new LSB index supports a shapefile with 2895 shapes, 10 
depth
     <citerefentry>
       <refentrytitle>shptreetst</refentrytitle>
       <manvolnum>1</manvolnum>
+    </citerefentry>,
+
+    <citerefentry>
+      <refentrytitle>sortshp</refentrytitle>
+      <manvolnum>1</manvolnum>
     </citerefentry>
   </refsect1>
 
diff --git a/debian/man/sortshp.1.xml b/debian/man/sortshp.1.xml
new file mode 100644
index 0000000..23ed129
--- /dev/null
+++ b/debian/man/sortshp.1.xml
@@ -0,0 +1,140 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" 
"http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd";>
+<refentry id='sortshp'>
+
+  <refmeta>
+    <refentrytitle>sortshp</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>sortshp</refname>
+    <refpurpose>sort a Shape data set</refpurpose>
+  </refnamediv>
+
+  <refsynopsisdiv id='synopsis'>
+    <cmdsynopsis>
+      <command>sortshp</command>
+      <group>
+        <arg choice='plain'>
+          <replaceable>infile</replaceable>
+          <arg choice='plain'><replaceable>outfile</replaceable></arg>
+          <arg choice='plain'><replaceable>item</replaceable></arg>
+          <group>
+            <arg choice='plain'><replaceable>ascending</replaceable></arg>
+            <arg choice='plain'><replaceable>descending</replaceable></arg>
+          </group>
+          <arg choice='plain'><replaceable></replaceable></arg>
+        </arg>
+        <arg choice='opt'>-v</arg>
+      </group>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1 id='description'>
+    <title>DESCRIPTION</title>
+    <para>
+      <command>sortshp</command> displays an example.
+    </para>
+  </refsect1>
+
+  <refsect1 id='options'>
+    <title>OPTIONS</title>
+    <variablelist>
+
+      <varlistentry>
+        <term><replaceable>infile</replaceable></term>
+        <listitem>
+          <para>The name of the .shp file</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><replaceable>outfile</replaceable></term>
+        <listitem>
+          <para>The name of the .shp/.shx and .dbf files to create</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><replaceable>item</replaceable></term>
+        <listitem>
+          <para>Name of the field to sort on</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><replaceable>ascending</replaceable></term>
+        <term><replaceable>descending</replaceable></term>
+        <listitem>
+          <para>Sort order (default: ascending)</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term>-v</term>
+        <listitem>
+          <para>Display mapserver version and build options.</para>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+  </refsect1>
+
+  <refsect1 id='example'>
+    <title>EXAMPLE</title>
+
+    <informalexample>
+      <para>
+        This example uses a roads file ('roads_ugl') that has a field with road
+        classes in integer format ('class1').
+      </para>
+
+      <screen>
+       sortshp roads_ugl roads-sort class1 ascending
+      </screen>
+
+      Result:
+      <blockquote>
+        A new Shape data set named 'roads-sort.shp' is created with shapes
+        sorted in ascending order, according to the values in the 'class1'
+        field.
+      </blockquote>
+
+      <figure id='before'>
+        <title>Figure 1: Attributes Before sortshp</title>
+        <ulink url="http://mapserver.org/_images/sortshp-before.png"/>
+      </figure>
+
+      <figure id='after'>
+        <title>Figure 2: Attributes After sortshp</title>
+        <ulink url="http://mapserver.org/_images/sortshp-after.png"/>
+      </figure>
+    </informalexample>
+  </refsect1>
+
+  <refsect1 id='see-also'>
+    <title>SEE ALSO</title>
+
+    <citerefentry>
+      <refentrytitle>shp2img</refentrytitle>
+      <manvolnum>1</manvolnum>
+    </citerefentry>,
+
+    <citerefentry>
+      <refentrytitle>shptree</refentrytitle>
+      <manvolnum>1</manvolnum>
+    </citerefentry>,
+
+    <citerefentry>
+      <refentrytitle>shptreetst</refentrytitle>
+      <manvolnum>1</manvolnum>
+    </citerefentry>,
+
+    <citerefentry>
+      <refentrytitle>shptreevis</refentrytitle>
+      <manvolnum>1</manvolnum>
+    </citerefentry>
+  </refsect1>
+
+</refentry>
diff --git a/debian/mapserver-bin.manpages b/debian/mapserver-bin.manpages
index 59398b3..82e8f3a 100644
--- a/debian/mapserver-bin.manpages
+++ b/debian/mapserver-bin.manpages
@@ -5,3 +5,4 @@ debian/man/shp2img.1
 debian/man/shptree.1
 debian/man/shptreetst.1
 debian/man/shptreevis.1
+debian/man/sortshp.1

-- 
Mapserver

_______________________________________________
Pkg-grass-devel mailing list
Pkg-grass-devel@lists.alioth.debian.org
http://lists.alioth.debian.org/cgi-bin/mailman/listinfo/pkg-grass-devel

Reply via email to