From 830e2c4012cd866be405eb41a01948b6a4145247 Mon Sep 17 00:00:00 2001
From: Jim DeFabia <jamesdefabia@lexisnexis.com>
Date: Tue, 24 Oct 2023 14:47:08 -0400
Subject: [PATCH] HPCC-16283 Document BUILD after MERGE

Signed-off-by: Jim DeFabia <jamesdefabia@lexisnexis.com>
---
 .../ECLR_mods/BltInFunc-BUILD.xml                   |  9 +++++++++
 .../ECLR_mods/BltInFunc-MERGE.xml                   | 13 ++++++++++---
 2 files changed, 19 insertions(+), 3 deletions(-)

diff --git a/docs/EN_US/ECLLanguageReference/ECLR_mods/BltInFunc-BUILD.xml b/docs/EN_US/ECLLanguageReference/ECLR_mods/BltInFunc-BUILD.xml
index cc2ca6c59de..ce1f7a21ab2 100644
--- a/docs/EN_US/ECLLanguageReference/ECLR_mods/BltInFunc-BUILD.xml
+++ b/docs/EN_US/ECLLanguageReference/ECLR_mods/BltInFunc-BUILD.xml
@@ -703,6 +703,15 @@ BUILD(Vehicles,SearchTerms,Payload,'vkey::st.city2');
     <programlisting>nameKey := INDEX(mainTable,{surname,forename,filepos},'name.idx');
 BUILD(nameKey); //gets all info from the INDEX definition
 </programlisting>
+
+    <para>You can also use this form to build an index based upon two MERGEd
+    indexes. To write a MERGEd index to disk, you must use the BUILD
+    action.</para>
+
+    <para>Example:</para>
+
+    <para><programlisting>BUILD(MERGE(idx1,idx2,'~idx::MergedIndex');
+</programlisting></para>
   </sect2>
 
   <sect2 id="SepIndexFromDS" role="brk">
diff --git a/docs/EN_US/ECLLanguageReference/ECLR_mods/BltInFunc-MERGE.xml b/docs/EN_US/ECLLanguageReference/ECLR_mods/BltInFunc-MERGE.xml
index 67c96a10256..9fd42996221 100644
--- a/docs/EN_US/ECLLanguageReference/ECLR_mods/BltInFunc-MERGE.xml
+++ b/docs/EN_US/ECLLanguageReference/ECLR_mods/BltInFunc-MERGE.xml
@@ -169,9 +169,14 @@
   <emphasis>recordsetset</emphasis>. This is particularly useful for
   incremental data updates as it allows you to merge a smaller set of new
   records into an existing large dataset or index without having to re-process
-  all the source data again. The <emphasis>recordsetset</emphasis> form makes
-  merging a variable number of datasets possible when used inside a GRAPH
-  function.</para>
+  all the source data again. </para>
+
+  <para>The <emphasis>recordsetset</emphasis> form makes merging a variable
+  number of datasets possible when used inside a GRAPH function.</para>
+
+  <para>To write a MERGEd index to disk, you must use the BUILD action.</para>
+
+  <?hard-pagebreak ?>
 
   <para>Example:</para>
 
@@ -192,4 +197,6 @@ ds4 := MERGE(SetDS,SORTED(letter,number));
 OUTPUT(ds3);
 OUTPUT(ds4);
 </programlisting>
+
+  <para>See Also: <link linkend="BUILD">BUILD</link></para>
 </sect1>