[postgis-tickets] r16686 - Put a note that ST_LineMerge strips M dimension. Provide an example of Z-dimension linestrings

[Regina Obe]

Author: robe
Date: 2018-08-11 01:58:20 -0700 (Sat, 11 Aug 2018)
New Revision: 16686

Modified:
   trunk/doc/reference_editor.xml
Log:
Put a note that ST_LineMerge strips M dimension.  Provide an example of Z-dimension linestrings
Closes #3317

Modified: trunk/doc/reference_editor.xml
===================================================================
--- trunk/doc/reference_editor.xml	2018-08-10 15:57:40 UTC (rev 16685)
+++ trunk/doc/reference_editor.xml	2018-08-11 08:58:20 UTC (rev 16686)
@@ -805,6 +805,7 @@
 
 			<para>Availability: 1.1.0</para>
 			<note><para>requires GEOS >= 2.1.0</para></note>
+			<warning><para>Will strip the M dimension.</para></note>
 		</refsection>
 
 		<refsection>
@@ -827,6 +828,16 @@
 st_astext
 ----------------
 MULTILINESTRING((-45.2 -33.2,-46 -32),(-29 -27,-30 -29.7,-36 -31,-45 -33))
+
+-- example with Z dimension
+SELECT ST_AsText(ST_LineMerge(
+ST_GeomFromText('MULTILINESTRING((-29 -27 11,-30 -29.7 10,-36 -31 5,-45 -33 6), (-29 -27 12,-30 -29.7 5), (-45 -33 1,-46 -32 11))')
+		)
+);
+st_astext
+--------------------------------------------------------------------------------------------------
+LINESTRING Z (-30 -29.7 5,-29 -27 11,-30 -29.7 10,-36 -31 5,-45 -33 1,-46 -32 11)
+(1 row)
 			</programlisting>
 		</refsection>
 		<refsection>