amend faqs and change Box2D,Box3D to ST_Box...

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

diff --git a/doc/faq.xml b/doc/faq.xml
index 9797f95adf0192aadade97af170ef101a25a5342..60a527a24a21c91b5a434906cd3b5dc0309669da 100644 (file)
--- a/doc/faq.xml
+++ b/doc/faq.xml
@@ -270,6 +270,33 @@ WHERE ST_DWithin(geocolumn, 'POINT(1000 1000)', 100.0);</programlisting>
 
         <programlisting>SELECT ST_Transform(the_geom,4269) FROM geotable;</programlisting>
       </answer>
+    </qandaentry>
+       
+       <qandaentry>
+      <question>
+        <para>I did an ST_AsEWKT and ST_AsText on my rather large geometry and it returned blank field.  What gives?</para>
+      </question>
+
+      <answer>
+        <para>You are probably using PgAdmin or some other tool that doesn't output large text.  If your geometry is big
+                       enough, it will appear blank in these tools. Use PSQL if you really need to see it or output it in WKT.</para>
+
+        <programlisting>
+                               --To check number of geometries are really blank
+                               SELECT count(gid) FROM geotable WHERE the_geom IS NULL;</programlisting>
+      </answer>
+    </qandaentry>
+       
+       <qandaentry>
+      <question>
+        <para>When I do an ST_Intersects, it says my two geometries don't intersect when I KNOW THEY DO</para>
+      </question>
+
+      <answer>
+        <para>This generally happens in two common cases.  Your geometry is invalid -- check <xref linkend="ST_IsValid" />
+                       or you are assuming they intersect because ST_AsText truncates the numbers and you have lots of decimals after 
+                               it is not showing you.</para>
+      </answer>
     </qandaentry>
   </qandaset>
 </chapter>
\ No newline at end of file

diff --git a/doc/reference_misc.xml b/doc/reference_misc.xml
index 19d01e16253c8d7294e92c982f79b72d5aaf736a..00fceedcdea416fbc7bc54dfb6b88d3102b430dd 100644 (file)
--- a/doc/reference_misc.xml
+++ b/doc/reference_misc.xml
@@ -59,9 +59,9 @@ all_em|grabone   | grab_rest
          </refsection>
        </refentry>
 
-       <refentry id="Box2D">
+       <refentry id="ST_Box2D">
          <refnamediv>
-               <refname>Box2D</refname>
+               <refname>ST_Box2D</refname>
 
                <refpurpose>Returns a BOX2D representing the maximum extents of the geometry.</refpurpose>
          </refnamediv>
@@ -86,12 +86,12 @@ all_em|grabone   | grab_rest
          <refsection>
                <title>Examples</title>
 
-               <programlisting>SELECT Box2D(ST_GeomFromText('LINESTRING(1 2, 3 4, 5 6)'));
+               <programlisting>SELECT ST_Box2D(ST_GeomFromText('LINESTRING(1 2, 3 4, 5 6)'));
        box2d
        ---------
        BOX(1 2,5 6)
 
-       SELECT Box2D(ST_GeomFromText('CIRCULARSTRING(220268 150415,220227 150505,220227 150406)'));
+       SELECT ST_Box2D(ST_GeomFromText('CIRCULARSTRING(220268 150415,220227 150505,220227 150406)'));
        box2d
        --------
        BOX(220186.984375 150406,220288.25 150506.140625)
@@ -102,13 +102,13 @@ all_em|grabone   | grab_rest
          <refsection>
                <title>See Also</title>
 
-               <para><xref linkend="Box3D" />, <xref linkend="ST_GeomFromText" /></para>
+               <para><xref linkend="ST_Box3D" />, <xref linkend="ST_GeomFromText" /></para>
          </refsection>
        </refentry>
 
-       <refentry id="Box3D">
+       <refentry id="ST_Box3D">
          <refnamediv>
-               <refname>Box3D</refname>
+               <refname>ST_Box3D</refname>
 
                <refpurpose>Returns a BOX3D representing the maximum extents of the geometry.</refpurpose>
          </refnamediv>
@@ -116,7 +116,7 @@ all_em|grabone   | grab_rest
          <refsynopsisdiv>
                <funcsynopsis>
                  <funcprototype>
-                       <funcdef>box3d <function>Box3D</function></funcdef>
+                       <funcdef>box3d <function>ST_Box3D</function></funcdef>
                        <paramdef><type>geometry </type> <parameter>geomA</parameter></paramdef>
                  </funcprototype>
                </funcsynopsis>
@@ -134,13 +134,13 @@ all_em|grabone   | grab_rest
          <refsection>
                <title>Examples</title>
 
-               <programlisting>SELECT Box3D(ST_GeomFromEWKT('LINESTRING(1 2 3, 3 4 5, 5 6 5)'));
-       box3d
+               <programlisting>SELECT ST_Box3D(ST_GeomFromEWKT('LINESTRING(1 2 3, 3 4 5, 5 6 5)'));
+       st_box3d
        ---------
        BOX3D(1 2 3,5 6 5)
 
-       SELECT Box3D(ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 150505 1,220227 150406 1)'));
-       box3d
+       SELECT ST_Box3D(ST_GeomFromEWKT('CIRCULARSTRING(220268 150415 1,220227 150505 1,220227 150406 1)'));
+       st_box3d
        --------
        BOX3D(220227 150406 1,220268 150415 1)
        </programlisting>
@@ -150,7 +150,7 @@ all_em|grabone   | grab_rest
          <refsection>
                <title>See Also</title>
 
-               <para><xref linkend="Box2D" />, <xref linkend="ST_GeomFromEWKT" /></para>
+               <para><xref linkend="ST_Box2D" />, <xref linkend="ST_GeomFromEWKT" /></para>
          </refsection>
        </refentry>