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

src/modules/dialog/README

@@ -126,6 +126,7 @@ Olle E. Johansson
               7.15. dlg_set_timeout_by_profile(profile, [value], timeout)
               7.16. dlg_set_property(attr)
               7.17. dlg_remote_profile(cmd, profile, value, uid, expires)
+              7.18. dlg_set_ruri()
 
         8. Statistics
 
@@ -249,6 +250,7 @@ Olle E. Johansson
    1.73. dlg_set_timeout_by_profile usage
    1.74. dlg_set_property usage
    1.75. dlg_remote_profile usage
+   1.76. dlg_set_ruri() usage
 
 Chapter 1. Admin Guide
 
@@ -343,6 +345,7 @@ Chapter 1. Admin Guide
         7.15. dlg_set_timeout_by_profile(profile, [value], timeout)
         7.16. dlg_set_property(attr)
         7.17. dlg_remote_profile(cmd, profile, value, uid, expires)
+        7.18. dlg_set_ruri()
 
    8. Statistics
 
@@ -1338,6 +1341,7 @@ end
    7.15. dlg_set_timeout_by_profile(profile, [value], timeout)
    7.16. dlg_set_property(attr)
    7.17. dlg_remote_profile(cmd, profile, value, uid, expires)
+   7.18. dlg_set_ruri()
 
 7.1.  set_dlg_profile(profile,[value])
 
@@ -1706,6 +1710,22 @@ $var(exp) = 3600 + $Ts;
 dlg_remote_profile("add", "caller", "test", "$sruid", "$var(exp)");
 ...
 
+7.18.  dlg_set_ruri()
+
+   This function sets the R-URI with the corresponding endpoint address
+   stored in dialog structure (i.e., its Contact field).
+
+   This function can be used from ANY_ROUTE.
+
+   Example 1.76. dlg_set_ruri() usage
+...
+if(has_totag() and is_present_hf("Route") and uri==myself ) {
+        if(dlg_set_ruri()) {
+                xlog("Request URI changed from [$ou] to dlg value: [$ru]\n");
+        }
+}
+...
+
 8. Statistics
 
    8.1. active_dialogs