api: add random integer number in evaluation of expressions with "random:min,max"

2 files changed, 14 insertions, 5 deletions

diff --git a/doc/ja/includes/autogen_user_commands.ja.adoc b/doc/ja/includes/autogen_user_commands.ja.adoc
index 21aca71da..d180d219b 100644
--- a/doc/ja/includes/autogen_user_commands.ja.adoc
+++ b/doc/ja/includes/autogen_user_commands.ja.adoc
@@ -1389,10 +1389,11 @@ Some variables are replaced in expression, using the format ${variable}, variabl
   15. an environment variable (format: "env:XXX")
   16. a ternary operator (format: "if:condition?value_if_true:value_if_false")
   17. result of an expression with parentheses and operators + - * / // % ** (format: "calc:xxx")
-  18. a translated string (format: "translate:xxx")
-  19. an option (format: "file.section.option")
-  20. a local variable in buffer
-  21. a hdata name/variable (the value is automatically converted to string), by default "window" and "buffer" point to current window/buffer.
+  18. a random integer number (format: "random:min,max")
+  19. a translated string (format: "translate:xxx")
+  20. an option (format: "file.section.option")
+  21. a local variable in buffer
+  22. a hdata name/variable (the value is automatically converted to string), by default "window" and "buffer" point to current window/buffer.
 Format for hdata can be one of following:
   hdata.var1.var2...: start with a hdata (pointer must be known), and ask variables one after one (other hdata can be followed)
   hdata[list].var1.var2...: start with a hdata using a list/pointer/pointer name, for example:
@@ -1424,6 +1425,7 @@ Examples (simple strings):
   /eval -n ${repeat:5,-}                         ==> -----
   /eval -n ${length:test}                        ==> 4
   /eval -n ${calc:(5+2)*3}                       ==> 21
+  /eval -n ${random:0,10}                        ==> 3
   /eval -n ${base_encode:64,test}                ==> dGVzdA==
   /eval -n ${base_decode:64,dGVzdA==}            ==> test
   /eval -n ${translate:Plugin}                   ==> Extension
diff --git a/doc/ja/weechat_plugin_api.ja.adoc b/doc/ja/weechat_plugin_api.ja.adoc
index 13b95e648..60b94aa98 100644
--- a/doc/ja/weechat_plugin_api.ja.adoc
+++ b/doc/ja/weechat_plugin_api.ja.adoc
@@ -2274,7 +2274,7 @@ str3 = weechat.string_input_for_buffer("//test")  # "/test"
 
 // TRANSLATION MISSING
 _WeeChat ≥ 0.4.0, updated in 0.4.2, 0.4.3, 1.0, 1.1, 1.2, 1.3, 1.6, 1.8, 2.0,
-2.2, 2.3, 2.7, 2.9, 3.1 and 3.2._
+2.2, 2.3, 2.7, 2.9, 3.1, 3.2 and 3.3._
 
 式を評価して文字列として返す。`+${variable}+`
 という書式で書かれた特殊変数は展開されます (以下の表を参照)。
@@ -2836,6 +2836,13 @@ str5 = weechat.string_eval_expression("password=abc password=def", {}, {}, optio
   `+65536+`
 
 // TRANSLATION MISSING
+| `+${random:min,max}+` +
+  _(WeeChat ≥ 3.3)_ |
+  Random integer number in the range from `min` to `max` (inclusive). |
+  `+${random:0,10}+` |
+  `+3+`
+
+// TRANSLATION MISSING
 | `+${translate:xxx}+` +
   _(WeeChat ≥ 3.2)_ |
   Translated string (depends on the language used by WeeChat to display messages). |