From: Sandro Santilli <strk@keybit.net>
Date: Thu, 14 Oct 2004 10:28:31 +0000 (+0000)
Subject: Updated pgsql2shp documentation.
X-Git-Tag: pgis_1_0_0RC1~283
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=72bd38d5dc48ede61968e9d3014de2acc71e6f4c;p=postgis

Updated pgsql2shp documentation.


git-svn-id: http://svn.osgeo.org/postgis/trunk@1001 b70326c6-7e19-0410-871a-916f4a2858ee
---

diff --git a/doc/postgis.xml b/doc/postgis.xml
index f9300fdb3..54a30de2f 100644
--- a/doc/postgis.xml
+++ b/doc/postgis.xml
@@ -446,7 +446,7 @@
       <para>The loader is called <filename>shp2pgsql</filename> and converts
       ESRI Shape files into SQL suitable for loading in PostGIS/PostgreSQL.
       The dumper is called <filename>pgsql2shp</filename> and converts PostGIS
-      tables into ESRI Shape files.</para>
+      tables (or queries) into ESRI Shape files.</para>
     </sect1>
   </chapter>
 
@@ -1302,23 +1302,16 @@ WHERE
         <title>Using the Dumper</title>
 
         <para>The <filename>pgsql2shp</filename> table dumper connects
-        directly to the database and converts a table into a shape file. The
+        directly to the database and converts a table (possibly defined by
+	a query) into a shape file. The
         basic syntax is:</para>
 
-        <programlisting>pgsql2shp [&lt;options&gt;] &lt;database&gt; &lt;table&gt;</programlisting>
+        <programlisting>pgsql2shp [&lt;options&gt;] &lt;database&gt; [&lt;schema&gt;.]&lt;table&gt;</programlisting>
+        <programlisting>pgsql2shp [&lt;options&gt;] &lt;database&gt; &lt;query&gt;</programlisting>
 
         <para>The commandline options are:</para>
 
         <variablelist>
-          <varlistentry>
-            <term>-d</term>
-
-            <listitem>
-              <para>Write a 3-dimensional shape file. The default is to write
-              a 2-dimensional shape file.</para>
-            </listitem>
-          </varlistentry>
-
           <varlistentry>
             <term>-f &lt;filename&gt;</term>
 
@@ -1388,6 +1381,19 @@ WHERE
               escape column names.</para>
             </listitem>
           </varlistentry>
+
+          <varlistentry>
+            <term>-d</term>
+
+            <listitem>
+	      <para>For backward compatibility: write a 3-dimensional shape
+	      file when dumping from old (pre-1.0.0) postgis databases (the
+	      default is to write a 2-dimensional shape file in that case).
+	      Starting from postgis-1.0.0+, dimensions are fully encoded.
+	      </para>
+            </listitem>
+          </varlistentry>
+
         </variablelist>
       </sect2>
     </sect1>