Merge pull request #10156 from JamesDeFabia/HPCC-17866UpperLimit

HPCC-17866 Document upper size limit for DATA/STRING types

Reviewed-by: Gavin Halliday <ghalliday@hpccsystems.com>

docs/ECLLanguageReference/ECLR_mods/Value-Data.xml

@@ -24,6 +24,8 @@
   role="bold">Working with BLOBs</emphasis> for more information on this
   subject.</para>
 
+  <para>The upper size limit for any DATA value is 4GB.</para>
+
   <para>Example:</para>
 
   <programlisting>DATA8 MyHexString := x'1234567890ABCDEF'; 

docs/ECLLanguageReference/ECLR_mods/Value-QString.xml

@@ -23,6 +23,8 @@
   to the size needed to contain the result of a cast or passed parameter. You
   may use set indexing into any QSTRING to parse out a substring.</para>
 
+  <para>The upper size limit for any QSTRING value is 4GB.</para>
+
   <para>Example:</para>
 
   <programlisting>QSTRING12 CompanyName := 'LEXISNEXIS';

docs/ECLLanguageReference/ECLR_mods/Value-String.xml

@@ -27,6 +27,8 @@
   the programmer is assumed to have supplied the correct hexadecimal EBCDIC
   value.</para>
 
+  <para>The upper size limit for any STRING value is 4GB.</para>
+
   <para>Example:</para>
 
   <programlisting>STRING1 MyString := IF(SomeAttribute &gt; 10,'1','0');

docs/ECLLanguageReference/ECLR_mods/Value-UTF8.xml

@@ -21,6 +21,8 @@
   while casting to any other type will first implicitly cast to STRING and
   then cast to the target value type.</para>
 
+  <para>The upper size limit for any UTF8 value is 4GB.</para>
+
   <para>Example:</para>
 
   <programlisting>utf8 FirstName := U'Noël'

docs/ECLLanguageReference/ECLR_mods/Value-Unicode.xml

@@ -24,6 +24,8 @@
   casting to any other type will first implicitly cast to STRING and then cast
   to the target value type.</para>
 
+  <para>The upper size limit for any UNICODE value is 4GB.</para>
+
   <para>Example:</para>
 
   <programlisting>UNICODE16 MyUNIString := U'1234567890ABCDEF';

docs/ECLLanguageReference/ECLR_mods/Value-VarString.xml

@@ -17,10 +17,14 @@
   parameter. You may use set indexing into any string to parse out a
   substring.</para>
 
+  <para>The upper size limit for any VARSTRING value is 4GB.</para>
+
   <para>Example:</para>
 
   <programlisting>VARSTRING3 MyString := 'ABC';
        // declares MyString a 3-byte null-terminated string</programlisting>
 
-  <para>See Also: <link linkend="LENGTH">LENGTH</link>, <link linkend="TRIM">TRIM</link>, <link linkend="Set_Ordering_and_Indexing">Set Ordering and Indexing</link></para>
+  <para>See Also: <link linkend="LENGTH">LENGTH</link>, <link
+  linkend="TRIM">TRIM</link>, <link linkend="Set_Ordering_and_Indexing">Set
+  Ordering and Indexing</link></para>
 </sect1>

docs/ECLLanguageReference/ECLR_mods/Value-VarUnicode.xml

@@ -23,6 +23,8 @@
   casting to any other type will first implicitly cast to STRING and then cast
   to the target value type.</para>
 
+  <para>The upper size limit for any VARUNICODE value is 4GB.</para>
+
   <para>Example:</para>
 
   <programlisting>VARUNICODE16 MyUNIString := U'1234567890ABCDEF';

docs/ECLProgrammersGuide/PRG_Mods/PrG_Workwith_Blobs.xml

@@ -43,7 +43,7 @@
     <emphasis>filename</emphasis> and <emphasis>filesize</emphasis>
     (FILENAME,FILESIZE) options if you need to be able to despray the contents
     of each record in the <emphasis>dstname</emphasis> back to the multiple
-    source files they originally came from. </para>
+    source files they originally came from.</para>
   </sect2>
 
   <sect2 id="Working_with_BLOB_Data">
@@ -76,6 +76,8 @@ imageData := DATASET('LE::imagedb',imageRecord,FLAT);
     contain an integer value specifying the number of bytes in the original
     file, followed by the XML data from the file.</para>
 
+    <para>The upper size limit for any STRING or DATA value is 4GB. </para>
+
     <para>The addition of the RecPos field (a standard ECL “record pointer”
     field) allows us to create an INDEX, like this:</para>