[postgis-commits] svn - r3557 - trunk/doc

postgis-commits at postgis.refractions.net postgis-commits at postgis.refractions.net
Thu Jan 22 09:46:21 PST 2009 

Author: kneufeld
Date: 2009-01-22 09:46:20 -0800 (Thu, 22 Jan 2009)
New Revision: 3557

Modified:
   trunk/doc/reference.xml
   trunk/doc/reference_new.xml
Log:
moved over <<, <<|, and >> from reference.xml to reference_new.xml in the documentation

Modified: trunk/doc/reference.xml
===================================================================
--- trunk/doc/reference.xml	2009-01-22 05:56:23 UTC (rev 3556)
+++ trunk/doc/reference.xml	2009-01-22 17:46:20 UTC (rev 3557)
@@ -157,35 +157,8 @@
     <sect2>
       <title>Operators</title>
 
-      <variablelist>	
+      <variablelist>
         <varlistentry>
-          <term>A &lt;&lt; B</term>
-
-          <listitem>
-            <para>The "&lt;&lt;" operator returns true if A's bounding box is
-            strictly to the left of B's bounding box.</para>
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term>A &gt;&gt; B</term>
-
-          <listitem>
-            <para>The "&gt;&gt;" operator returns true if A's bounding box is
-            strictly to the right of B's bounding box.</para>
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
-          <term>A &lt;&lt;| B</term>
-
-          <listitem>
-            <para>The "&lt;&lt;|" operator returns true if A's bounding box is
-            strictly below B's bounding box.</para>
-          </listitem>
-        </varlistentry>
-
-        <varlistentry>
           <term>A |&gt;&gt; B</term>
 
           <listitem>

Modified: trunk/doc/reference_new.xml
===================================================================
--- trunk/doc/reference_new.xml	2009-01-22 05:56:23 UTC (rev 3556)
+++ trunk/doc/reference_new.xml	2009-01-22 17:46:20 UTC (rev 3557)
@@ -7915,6 +7915,198 @@
 		  </refsection>
 		</refentry>
 
+		<refentry id="ST_Geometry_Left">	
+		  <refnamediv>
+		    <refname>&lt;&lt;</refname>
+		
+		    <refpurpose>Returns <varname>TRUE</varname> if A is strictly to the left of B.</refpurpose>
+		  </refnamediv>
+		
+		  <refsynopsisdiv>
+		    <funcsynopsis>
+		      <funcprototype>
+		        <!-- TODO: Ideally, it would be nice if this coule be reordered to 
+		        "boolean (geometry A << geometry B)" instead of 
+		        "boolean <<( geometry A, geometry B)" -->
+		        <funcdef>boolean <function>&lt;&lt;</function></funcdef>
+		
+		        <paramdef>
+		          <type>geometry </type>
+		
+		          <parameter>A</parameter>
+		        </paramdef>
+		
+		        <paramdef>
+		          <type>geometry </type>
+		
+		          <parameter>B</parameter>
+		        </paramdef>
+		      </funcprototype>
+		    </funcsynopsis>
+		  </refsynopsisdiv>
+		
+		  <refsection>
+		    <title>Description</title>
+		
+		    <para>The <varname>&lt;&lt;</varname> operator returns <varname>TRUE</varname> if the bounding box of geometry A
+            is strickly to the left of the bounding box of geometry B.</para>
+		  </refsection>
+		
+		  <refsection>
+		    <title>Examples</title>
+		
+		    <programlisting>SELECT tbl1.column1, tbl2.column1, tbl1.column2 &lt;&lt; tbl2.column2 AS overlaps
+FROM 
+  ( VALUES
+	(1, 'LINESTRING (1 2, 1 5)'::geometry)) AS tbl1,
+  ( VALUES
+	(2, 'LINESTRING (0 0, 4 3)'::geometry), 
+	(3, 'LINESTRING (6 0, 6 5)'::geometry), 
+	(4, 'LINESTRING (2 2, 5 6)'::geometry)) AS tbl2;
+
+ column1 | column1 | overlaps 
+---------+---------+----------
+       1 |       2 | f
+       1 |       3 | t
+       1 |       4 | t
+(3 rows)</programlisting>
+		  </refsection>
+		
+		  <refsection>
+		    <title>See Also</title>
+		
+		    <para><xref linkend="ST_Geometry_Right" />, <xref linkend="ST_Geometry_Below" /></para>
+		  </refsection>
+		</refentry>
+
+		<refentry id="ST_Geometry_Below">	
+		  <refnamediv>
+		    <refname>&lt;&lt;|</refname>
+		
+		    <refpurpose>Returns <varname>TRUE</varname> if A is strictly below B.</refpurpose>
+		  </refnamediv>
+		
+		  <refsynopsisdiv>
+		    <funcsynopsis>
+		      <funcprototype>
+		        <!-- TODO: Ideally, it would be nice if this coule be reordered to 
+		        "boolean (geometry A <<| geometry B)" instead of 
+		        "boolean <<|( geometry A, geometry B)" -->
+		        <funcdef>boolean <function>&lt;&lt;|</function></funcdef>
+		
+		        <paramdef>
+		          <type>geometry </type>
+		
+		          <parameter>A</parameter>
+		        </paramdef>
+		
+		        <paramdef>
+		          <type>geometry </type>
+		
+		          <parameter>B</parameter>
+		        </paramdef>
+		      </funcprototype>
+		    </funcsynopsis>
+		  </refsynopsisdiv>
+		
+		  <refsection>
+		    <title>Description</title>
+		
+		    <para>The <varname>&lt;&lt;|</varname> operator returns <varname>TRUE</varname> if the bounding box of geometry A
+            is strickly below the bounding box of geometry B.</para>
+		  </refsection>
+		
+		  <refsection>
+		    <title>Examples</title>
+		
+		    <programlisting>SELECT tbl1.column1, tbl2.column1, tbl1.column2 &lt;&lt;| tbl2.column2 AS overlaps
+FROM 
+  ( VALUES
+	(1, 'LINESTRING (0 0, 4 3)'::geometry)) AS tbl1,
+  ( VALUES
+	(2, 'LINESTRING (1 4, 1 7)'::geometry), 
+	(3, 'LINESTRING (6 1, 6 5)'::geometry), 
+	(4, 'LINESTRING (2 3, 5 6)'::geometry)) AS tbl2;
+
+ column1 | column1 | overlaps 
+---------+---------+----------
+       1 |       2 | t
+       1 |       3 | f
+       1 |       4 | f
+(3 rows)</programlisting>
+		  </refsection>
+		
+		  <refsection>
+		    <title>See Also</title>
+		
+		    <para><xref linkend="ST_Geometry_Left" />, <xref linkend="ST_Geometry_Right" /></para>
+		  </refsection>
+		</refentry>
+		
+		<refentry id="ST_Geometry_Right">	
+		  <refnamediv>
+		    <refname>&gt;&gt;</refname>
+		
+		    <refpurpose>Returns <varname>TRUE</varname> if A is strictly to the right of B.</refpurpose>
+		  </refnamediv>
+		
+		  <refsynopsisdiv>
+		    <funcsynopsis>
+		      <funcprototype>
+		        <!-- TODO: Ideally, it would be nice if this coule be reordered to 
+		        "boolean (geometry A >> geometry B)" instead of 
+		        "boolean >>( geometry A, geometry B)" -->
+		        <funcdef>boolean <function>&gt;&gt;</function></funcdef>
+		
+		        <paramdef>
+		          <type>geometry </type>
+		
+		          <parameter>A</parameter>
+		        </paramdef>
+		
+		        <paramdef>
+		          <type>geometry </type>
+		
+		          <parameter>B</parameter>
+		        </paramdef>
+		      </funcprototype>
+		    </funcsynopsis>
+		  </refsynopsisdiv>
+		
+		  <refsection>
+		    <title>Description</title>
+		
+		    <para>The <varname>&gt;&gt;</varname> operator returns <varname>TRUE</varname> if the bounding box of geometry A
+            is strickly to the right of the bounding box of geometry B.</para>
+		  </refsection>
+		
+		  <refsection>
+		    <title>Examples</title>
+		
+		    <programlisting>SELECT tbl1.column1, tbl2.column1, tbl1.column2 &gt;&gt; tbl2.column2 AS overlaps
+FROM 
+  ( VALUES
+	(1, 'LINESTRING (2 3, 5 6)'::geometry)) AS tbl1,
+  ( VALUES
+	(2, 'LINESTRING (1 4, 1 7)'::geometry), 
+	(3, 'LINESTRING (6 1, 6 5)'::geometry), 
+	(4, 'LINESTRING (0 0, 4 3)'::geometry)) AS tbl2;
+
+ column1 | column1 | overlaps 
+---------+---------+----------
+       1 |       2 | t
+       1 |       3 | f
+       1 |       4 | f
+(3 rows)</programlisting>
+		  </refsection>
+		
+		  <refsection>
+		    <title>See Also</title>
+		
+		    <para><xref linkend="ST_Geometry_Left" />, <xref linkend="ST_Geometry_Below" /></para>
+		  </refsection>
+		</refentry>
+
 		<refentry id="ST_Geometry_Overabove">	
 		  <refnamediv>
 		    <refname>|&amp;&gt;</refname>

More information about the postgis-commits mailing list