modules: readme files regenerated - textopsx ... [skip ci]

src/modules/textopsx/README

@@ -45,6 +45,8 @@ Daniel-Constantin Mierla
               2.24. bl_iterator_end(iname)
               2.25. textopsx.f.bl_iterator_next(iname)
               2.26. bl_iterator_rm(iname)
+              2.27. bl_iterator_append(iname, text)
+              2.28. bl_iterator_insert(iname, text)
 
         3. Selects
 
@@ -80,7 +82,9 @@ Daniel-Constantin Mierla
    1.24. bl_iterator_end usage
    1.25. bl_iterator_next usage
    1.26. bl_iterator_rm usage
-   1.27. @hf_value select usage
+   1.27. bl_iterator_append usage
+   1.28. bl_iterator_insert usage
+   1.29. @hf_value select usage
 
 Chapter 1. Admin Guide
 
@@ -115,6 +119,8 @@ Chapter 1. Admin Guide
         2.24. bl_iterator_end(iname)
         2.25. textopsx.f.bl_iterator_next(iname)
         2.26. bl_iterator_rm(iname)
+        2.27. bl_iterator_append(iname, text)
+        2.28. bl_iterator_insert(iname, text)
 
    3. Selects
 
@@ -160,6 +166,8 @@ Chapter 1. Admin Guide
    2.24. bl_iterator_end(iname)
    2.25. textopsx.f.bl_iterator_next(iname)
    2.26. bl_iterator_rm(iname)
+   2.27. bl_iterator_append(iname, text)
+   2.28. bl_iterator_insert(iname, text)
 
 2.1.  msg_apply_changes()
 
@@ -653,6 +661,46 @@ bl_iterator_end("b1");
     bl_iterator_end("b1");
 ...
 
+2.27.  bl_iterator_append(iname, text)
+
+   Add text after the line at the current iterator possition.
+
+   The parameters can be dynamic strings with variables.
+
+   This function can be used from ANY_ROUTE.
+
+   Example 1.27. bl_iterator_append usage
+...
+    bl_iterator_start("b1");
+    while(bl_iterator_next("b1")) {
+        if($blitval(b1)=~"^a=info:xyz") {
+            bl_iterator_append("b1", "a=info:abc\r\n");
+            break;
+        }
+    }
+    bl_iterator_end("b1");
+...
+
+2.28.  bl_iterator_insert(iname, text)
+
+   Add text before the line at the current iterator possition.
+
+   The parameters can be dynamic strings with variables.
+
+   This function can be used from ANY_ROUTE.
+
+   Example 1.28. bl_iterator_insert usage
+...
+    bl_iterator_start("b1");
+    while(bl_iterator_next("b1")) {
+        if($blitval(b1)=~"^a=info:xyz") {
+            bl_iterator_insert("b1", "a=info:abc\r\n");
+            break;
+        }
+    }
+    bl_iterator_end("b1");
+...
+
 3. Selects
 
    3.1. @hf_value
@@ -688,7 +736,7 @@ bl_iterator_end("b1");
      * IDX - Value index, negative value counts from bottom
      * PARAM_NAME - name of parameter
 
-   Example 1.27. @hf_value select usage
+   Example 1.29. @hf_value select usage
 ...
 $a = @hf_value.my_header[1].my_param;
 xplog("L_ERR", "$sel(@hf_value.via[-1]), $sel(@hf_value.from.tag)\n");