From 37b6377a61c18e2f49ed9c3b5ebba7adc2a01e79 Mon Sep 17 00:00:00 2001
From: Regina Obe <lr@pcorp.us>
Date: Sat, 11 Aug 2018 08:58:20 +0000
Subject: [PATCH] Put a note that ST_LineMerge strips M dimension.  Provide an
 example of Z-dimension linestrings Closes #3317

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

diff --git a/doc/reference_editor.xml b/doc/reference_editor.xml
index 30da2972f..6a6d0f749 100644
--- a/doc/reference_editor.xml
+++ b/doc/reference_editor.xml
@@ -805,6 +805,7 @@ GEOMETRYCOLLECTION(
 
 			<para>Availability: 1.1.0</para>
 			<note><para>requires GEOS &gt;= 2.1.0</para></note>
+			<warning><para>Will strip the M dimension.</para></note>
 		</refsection>
 
 		<refsection>
@@ -827,6 +828,16 @@ ST_GeomFromText('MULTILINESTRING((-29 -27,-30 -29.7,-36 -31,-45 -33),(-45.2 -33.
 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>
-- 
2.40.0