[postgis-tickets] r15341 - Clarify behavior of ST_IsPolygon{CW, CCW} with closed linestrings

[Sandro Santilli]

Author: strk
Date: 2017-03-20 08:59:16 -0700 (Mon, 20 Mar 2017)
New Revision: 15341

Modified:
   trunk/doc/reference_accessor.xml
Log:
Clarify behavior of ST_IsPolygon{CW,CCW} with closed linestrings

Modified: trunk/doc/reference_accessor.xml
===================================================================
--- trunk/doc/reference_accessor.xml	2017-03-20 13:24:07 UTC (rev 15340)
+++ trunk/doc/reference_accessor.xml	2017-03-20 15:59:16 UTC (rev 15341)
@@ -901,8 +901,8 @@
 			<title>Description</title>
 
 			<para>
-				Returns true if all polygonal components of the input geometry use a counter-clockwise 
-				orientation for their exterior ring, and a clockwise direction 
+				Returns true if all polygonal components of the input geometry use a counter-clockwise
+				orientation for their exterior ring, and a clockwise direction
 				for all interior rings.
 			</para>
 
@@ -912,17 +912,18 @@
 
 			<note>
 				<para>
-					If a polygonal geometry does not use reversed orientation
-					for interior rings (i.e., if one or more interior rings
-					are oriented in the same direction as an exterior ring)
-					then both ST_IsPolygonCW and ST_IsPolygonCCW will return false.
+					Closed linestrings are not considered polygonal components,
+					so you would still get a true return by passing
+          a single closed linestring no matter its orientation.
 				</para>
 			</note>
 
 			<note>
 				<para>
-					This function does not consider closed linestrings as polygons,
-					and does not check their orientation.
+					If a polygonal geometry does not use reversed orientation
+					for interior rings (i.e., if one or more interior rings
+					are oriented in the same direction as an exterior ring)
+					then both ST_IsPolygonCW and ST_IsPolygonCCW will return false.
 				</para>
 			</note>
 
@@ -970,8 +971,8 @@
 			<title>Description</title>
 
 			<para>
-				Returns true if all polygonal components of the input geometry use a clockwise 
-				orientation for their exterior ring, and a counter-clockwise direction 
+				Returns true if all polygonal components of the input geometry use a clockwise
+				orientation for their exterior ring, and a counter-clockwise direction
 				for all interior rings.
 			</para>
 
@@ -981,17 +982,18 @@
 
 			<note>
 				<para>
-					If a polygonal geometry does not use reversed orientation
-					for interior rings (i.e., if one or more interior rings
-					are oriented in the same direction as an exterior ring)
-					then both ST_IsPolygonCW and ST_IsPolygonCCW will return false.
+					Closed linestrings are not considered polygonal components,
+					so you would still get a true return by passing
+          a single closed linestring no matter its orientation.
 				</para>
 			</note>
 
 			<note>
 				<para>
-					This function does not consider closed linestrings as polygons,
-					and does not check their orientation.
+					If a polygonal geometry does not use reversed orientation
+					for interior rings (i.e., if one or more interior rings
+					are oriented in the same direction as an exterior ring)
+					then both ST_IsPolygonCW and ST_IsPolygonCCW will return false.
 				</para>
 			</note>