From 29bd8be7c7d399ba99b1f1c6185c4f2ff0fb53f8 Mon Sep 17 00:00:00 2001
From: Regina Obe <lr@pcorp.us>
Date: Fri, 28 Aug 2009 18:38:34 +0000
Subject: [PATCH] Put in image of ST_ConvexHull

git-svn-id: http://svn.osgeo.org/postgis/trunk@4436 b70326c6-7e19-0410-871a-916f4a2858ee
---
 doc/html/image_src/Makefile.in         |  1 +
 doc/html/image_src/st_convexhull01.wkt |  3 +++
 doc/reference.xml                      | 33 +++++++++++++++++++++-----
 3 files changed, 31 insertions(+), 6 deletions(-)
 create mode 100644 doc/html/image_src/st_convexhull01.wkt

diff --git a/doc/html/image_src/Makefile.in b/doc/html/image_src/Makefile.in
index 68a6a480e..007239583 100644
--- a/doc/html/image_src/Makefile.in
+++ b/doc/html/image_src/Makefile.in
@@ -37,6 +37,7 @@ IMAGES= \
 	../images/st_contains04.png \
 	../images/st_contains05.png \
 	../images/st_contains06.png \
+	../images/st_convexhull01.png \
 	../images/st_crosses01.png \
 	../images/st_crosses02.png \
 	../images/st_crosses03.png \
diff --git a/doc/html/image_src/st_convexhull01.wkt b/doc/html/image_src/st_convexhull01.wkt
new file mode 100644
index 000000000..930d41af5
--- /dev/null
+++ b/doc/html/image_src/st_convexhull01.wkt
@@ -0,0 +1,3 @@
+Style1;POLYGON((3 4,100 190,10 8,3 4))
+Style2;LINESTRING(100 190,10 8)
+Style2;POINT(3 4)
diff --git a/doc/reference.xml b/doc/reference.xml
index 96feac42e..ec757eb5c 100644
--- a/doc/reference.xml
+++ b/doc/reference.xml
@@ -12122,19 +12122,40 @@ MULTILINESTRING((1 2,3 4),(3 4,4 5))
 
 	  <refsection>
 		<title>Examples</title>
-<programlisting>SELECT d.disease_type,
+<programlisting>
+--Get estimate of infected area based on point observations
+SELECT d.disease_type,
 	ST_ConvexHull(ST_Collect(d.the_geom)) As the_geom
 	FROM disease_obs As d
 	GROUP BY d.disease_type;
+</programlisting>
 
-	SELECT ST_AsEWKT(ST_ConvexHull(
+<informaltable>
+	<tgroup cols="1">
+	  <tbody>
+		<row>
+		  <entry><para><informalfigure>
+			  <mediaobject>
+				<imageobject>
+				  <imagedata fileref="images/st_convexhull01.png" />
+				</imageobject>
+				<caption><para>Convex Hull of a Linestring and a Point</para></caption>
+			  </mediaobject>
+			</informalfigure>
+				<programlisting>
+SELECT ST_AsText(ST_ConvexHull(
 		ST_Collect(
-			ST_GeomFromEWKT('LINESTRING(1 2 3,3 4 5)'),
-				ST_MakePoint(0, 2, 0))
+			ST_GeomFromText('LINESTRING(100 190,10 8)'),
+				ST_MakePoint(3, 4))
 				));
-	---st_asewkt--
-	POLYGON((0 2 0,3 4 5,1 2 3,0 2 0))
+	---st_astext--
+POLYGON((3 4,100 190,10 8,3 4))
 				</programlisting>
+	</para></entry>
+		</row>
+	</tbody>
+</tgroup>
+</informaltable>
 	  </refsection>
 	  <refsection>
 		<title>See Also</title>
-- 
2.50.0