From 3d0a3e7e6e8bff90c3330840597ddc752bcc0fc3 Mon Sep 17 00:00:00 2001
From: =?utf8?q?Jorge=20Ar=C3=A9valo?= <jorge.arevalo at deimos-space.com>
Date: Tue, 15 Mar 2011 15:11:12 +0000
Subject: [PATCH] Added ST_IsEmpty documentation. Related ticket #591.

git-svn-id: http://svn.osgeo.org/postgis/trunk@6902 b70326c6-7e19-0410-871a-916f4a2858ee
---
 doc/reference_raster.xml | 45 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)

diff --git a/doc/reference_raster.xml b/doc/reference_raster.xml
index 5ea0a20b8..5ea81e644 100644
--- a/doc/reference_raster.xml
+++ b/doc/reference_raster.xml
@@ -1583,6 +1583,51 @@ FROM dummy_rast;
 				<para><xref linkend="RT_ST_Raster2WorldCoordX" />, <xref linkend="RT_ST_Raster2WorldCoordY" />, <xref linkend="RT_ST_SRID" /></para>
 			</refsection>
 		</refentry>
+
+		<refentry id="RT_ST_IsEmpty">
+			<refnamediv>
+				<refname>ST_IsEmpty</refname>
+				<refpurpose>Returns true if the raster is empty (width = 0 and height = 0). Otherwise, returns false.</refpurpose>
+			</refnamediv>
+		
+			<refsynopsisdiv>
+				<funcsynopsis>
+				  <funcprototype>
+					<funcdef>boolean <function>ST_IsEmpty</function></funcdef>
+					<paramdef><type>raster </type> <parameter>rast</parameter></paramdef>
+				  </funcprototype>
+			    </funcsynopsis>
+			</refsynopsisdiv>
+		
+			<refsection>
+				<title>Description</title>
+				
+				<para>Returns true if the raster is empty (width = 0 and height = 0). Otherwise, returns false.</para>
+			</refsection>
+				
+			<refsection>
+				<title>Examples</title>
+			
+				<programlisting>SELECT ST_IsEmpty(ST_MakeEmptyRaster(100, 100, 0, 0, 0, 0, 0, 0))
+st_isempty |
+-----------+
+f          |
+                       
+                        
+SELECT ST_IsEmpty(ST_MakeEmptyRaster(0, 0, 0, 0, 0, 0, 0, 0))
+st_isempty |
+-----------+
+t          |
+
+                </programlisting>	
+			</refsection>
+		
+			<!-- Optionally add a "See Also" section -->
+			<refsection>
+				<title>See Also</title>
+				<para><xref linkend="RT_ST_HasNoBand" /></para>
+			</refsection>
+		</refentry>
 	</sect1>
 	
 	<sect1 id="RasterBand_Accessors">
-- 
2.50.1