From: Regina Obe <lr@pcorp.us>
Date: Mon, 7 Jul 2014 23:17:59 +0000 (+0000)
Subject: Change link id of ST_Force2D from ST_Force_2D to ST_Force2Dm add doco for ST_Straight... 
X-Git-Tag: 2.2.0rc1~997
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=ec5fd0a9f7f6d7605bf548426ae2a13cce714af3;p=postgis

Change link id of ST_Force2D from ST_Force_2D to ST_Force2Dm add doco for ST_StraightSkeleton, add example of switching backend to sfcgal

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

diff --git a/doc/html/image_src/Makefile.in b/doc/html/image_src/Makefile.in
index cb934afee..0f6bd83b6 100644
--- a/doc/html/image_src/Makefile.in
+++ b/doc/html/image_src/Makefile.in
@@ -107,6 +107,8 @@ IMAGES= \
 	../images/st_split02.png \
 	../images/st_split03.png \
 	../images/st_split04.png \
+	../images/st_straightskeleton01.png \
+	../images/st_straigntskeleton02.png \
 	../images/st_symdifference01.png \
 	../images/st_symdifference02.png \
 	../images/st_touches01.png \
diff --git a/doc/html/image_src/st_straightskeleton01.wkt b/doc/html/image_src/st_straightskeleton01.wkt
new file mode 100644
index 000000000..b212002ec
--- /dev/null
+++ b/doc/html/image_src/st_straightskeleton01.wkt
@@ -0,0 +1,2 @@
+Style1;POLYGON((175 150, 20 40, 50 60, 125 100, 175 150))
+
diff --git a/doc/html/image_src/st_straightskeleton02.wkt b/doc/html/image_src/st_straightskeleton02.wkt
new file mode 100644
index 000000000..fd68b3380
--- /dev/null
+++ b/doc/html/image_src/st_straightskeleton02.wkt
@@ -0,0 +1,5 @@
+Style2;LINESTRING(175 150,121.456565534391 104.78234711288)
+Style2;LINESTRING(20 40,49.7293800158567 60.4525085450564)
+Style2;LINESTRING(50 60,49.7293800158567 60.4525085450564)
+Style2;LINESTRING(125 100,121.456565534391 104.78234711288)
+Style2;LINESTRING(49.7293800158567 60.4525085450564,121.456565534391 104.78234711288)
diff --git a/doc/reference_editor.xml b/doc/reference_editor.xml
index 6c99d5f2c..14557b5ea 100644
--- a/doc/reference_editor.xml
+++ b/doc/reference_editor.xml
@@ -170,7 +170,7 @@ SELECT ST_AsEWKT(ST_Affine(the_geom, cos(pi()), -sin(pi()), 0, sin(pi()), cos(pi
 	  </refsection>
 	</refentry>
 
-	<refentry id="ST_Force_2D">
+	<refentry id="ST_Force2D">
 	  <refnamediv>
 		<refname>ST_Force2D</refname>
 
diff --git a/doc/reference_guc.xml b/doc/reference_guc.xml
index 10f333ba1..d3d55f502 100644
--- a/doc/reference_guc.xml
+++ b/doc/reference_guc.xml
@@ -18,6 +18,15 @@
         <para>This GUC is only relevant if you compiled PostGIS with sfcgal support.  By default <varname>geos</varname> backend is used for functions where both GEOS and SFCGAL have the same named function.  This variable allows you to override and make sfcgal the backend to service the request.</para>
         <para>Availability: 2.1.0</para>
       </refsection>
+      
+      <refsection>
+      	<title>Examples</title>
+      	<para>Sets backend just for life of connection</para>
+      	<programlisting>set postgis.backend = sfcgal;</programlisting>
+      	
+      	<para>Sets backend for new connections to database</para>
+      	<programlisting>ALTER DATABASE mygisdb SET postgis.backend = sfcgal;</programlisting>
+      </refsection>
       <refsection>
 			  <title>See Also</title>
 			  <para><xref linkend="reference_sfcgal" /></para>
diff --git a/doc/reference_sfcgal.xml b/doc/reference_sfcgal.xml
index 389fc8230..a574541d7 100644
--- a/doc/reference_sfcgal.xml
+++ b/doc/reference_sfcgal.xml
@@ -99,6 +99,37 @@
 		<para>&P_support;</para>
 		<para>&T_support;</para>
 	  </refsection>
+	  
+	  <refsection><title>Examples</title>
+	  		<programlisting>SELECT ST_StraightSkeleton(ST_GeomFromText('POLYGON((175 150, 20 40, 50 60, 125 100, 175 150))'));</programlisting>
+	  		
+	  	 <informaltable>
+				  <tgroup cols="2">
+					<tbody>
+					  <row>
+						<entry><para><informalfigure>
+							<mediaobject>
+							  <imageobject>
+								<imagedata fileref="images/st_straightskeleton01.png" />
+							  </imageobject>
+							  <caption><para>Original polygon</para></caption>
+							</mediaobject>
+						  </informalfigure></para>
+					  </entry>
+					  <entry><para><informalfigure>
+							<mediaobject>
+							  <imageobject>
+								<imagedata fileref="images/st_straightskeleton02.png" />
+							  </imageobject>
+							  <caption><para>Straight Skeleton of polygon</para></caption>
+							</mediaobject>
+						  </informalfigure></para>
+					  </entry>
+				</row>
+				</tbody>
+				</tgroup>
+			</informaltable>
+	  </refsection>
 
 	</refentry>