Commit today's edits.

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

diff --git a/doc/postgis.xml b/doc/postgis.xml
index b8fdb48e1d7edb19cee0e73cda685d1c1b52d62c..3fcc55e12bdbd9bcf5df4ca6d6d10f64039c421a 100644 (file)
--- a/doc/postgis.xml
+++ b/doc/postgis.xml
@@ -1540,6 +1540,61 @@ WHERE the_geom && 'BOX3D(90900 190900, 100100 200100)'::box3d
         this will drastically reduce the number of distance calculations that
         need to be done.</para>
       </sect2>
+
+      <sect2>
+        <title>Examples of Spatial SQL</title>
+
+        <para>The examples in this section will make use of two tables, a
+        table of linear roads, and a table of polygonal municipality
+        boundaries. The table definitions for the <varname>bc_roads</varname>
+        table is:</para>
+
+        <programlisting>  Column    |       Type        |   Description
+------------+-------------------+-------------------
+ gid        | integer           | Unique ID
+ name       | character varying | Road Name
+ type       | character varying | Road Type Number</programlisting>
+
+        <para>The table definition for the <varname>bc_municipality</varname>
+        table is:</para>
+
+        <programlisting>  Column   |       Type        |   Description
+-----------+-------------------+-------------------
+ gid       | integer           | Unique ID
+ code      | integer           | Unique ID
+ name      | character varying | City / Town Name
+ the_geom  | geometry          | Location Geometry (Polygon)</programlisting>
+
+        <qandaset>
+          <qandadiv>
+            <qandaentry>
+              <question>
+                <para>Find all the roads within 1 kilometer of a point.</para>
+              </question>
+
+              <answer>
+                <para>You can answer this question with a very simple piece of
+                SQL:</para>
+
+                <programlisting>SELECT * FROM geom_table WHERE Distance( the_geom, </programlisting>
+              </answer>
+            </qandaentry>
+
+            <qandaentry>
+              <question>
+                <para>Find the length of all roads</para>
+              </question>
+
+              <answer>
+                <para>You can answer this question with a very simple piece of
+                SQL:</para>
+
+                <programlisting>SELECT * FROM geom_table WHERE Distance( the_geom, </programlisting>
+              </answer>
+            </qandaentry>
+          </qandadiv>
+        </qandaset>
+      </sect2>
     </sect1>
 
     <sect1>