summaryrefslogtreecommitdiff
path: root/doc/it
diff options
context:
space:
mode:
authorSébastien Helleu <flashcode@flashtux.org>2021-02-05 20:07:16 +0100
committerSébastien Helleu <flashcode@flashtux.org>2021-02-05 20:07:16 +0100
commita93e598c358574fcc20b5e8ed34b19cc773f143d (patch)
treee344d8842b233d8cd0121d701b44a6e879cd1cfe /doc/it
parent64fe602aaecb462ec6b0a0fb5916416de39de7be (diff)
downloadweechat-a93e598c358574fcc20b5e8ed34b19cc773f143d.zip
core: add raw string in evaluation of expressions with "raw:xxx" (closes #1611)
Diffstat (limited to 'doc/it')
-rw-r--r--doc/it/includes/autogen_user_commands.it.adoc40
-rw-r--r--doc/it/weechat_plugin_api.it.adoc7
2 files changed, 28 insertions, 19 deletions
diff --git a/doc/it/includes/autogen_user_commands.it.adoc b/doc/it/includes/autogen_user_commands.it.adoc
index d613e8c41..96a42df00 100644
--- a/doc/it/includes/autogen_user_commands.it.adoc
+++ b/doc/it/includes/autogen_user_commands.it.adoc
@@ -1341,26 +1341,27 @@ To force a string comparison, you can add double quotes around each expression,
"50" > "100" ==> 1
Some variables are replaced in expression, using the format ${variable}, variable can be, by order of priority:
- 1. an evaluated sub-string (format: "eval:xxx")
- 2. an evaluated condition (format: "eval_cond:xxx")
- 3. a string with escaped chars (format: "esc:xxx" or "\xxx")
- 4. a string with chars to hide (format: "hide:char,string")
- 5. a string with max chars (format: "cut:max,suffix,string" or "cut:+max,suffix,string")
+ 1. the string itself without evaluation (format: "raw:xxx")
+ 2. an evaluated sub-string (format: "eval:xxx")
+ 3. an evaluated condition (format: "eval_cond:xxx")
+ 4. a string with escaped chars (format: "esc:xxx" or "\xxx")
+ 5. a string with chars to hide (format: "hide:char,string")
+ 6. a string with max chars (format: "cut:max,suffix,string" or "cut:+max,suffix,string")
or max chars displayed on screen (format: "cutscr:max,suffix,string" or "cutscr:+max,suffix,string")
- 6. a reversed string (format: "rev:xxx" or "revscr:xxx")
- 7. a repeated string (format: "repeat:count,string")
- 8. length of a string (format: "length:xxx" or "lengthscr:xxx")
- 9. a color (format: "color:xxx", see "Plugin API reference", function "color")
- 10. a modifier (format: "modifier:name,data,string")
- 11. an info (format: "info:name,arguments", arguments are optional)
- 12. a base 16/32/64 encoded/decoded string (format: "base_encode:base,xxx" or "base_decode:base,xxx")
- 13. current date/time (format: "date" or "date:format")
- 14. an environment variable (format: "env:XXX")
- 15. a ternary operator (format: "if:condition?value_if_true:value_if_false")
- 16. result of an expression with parentheses and operators + - * / // % ** (format: "calc:xxx")
- 17. an option (format: "file.section.option")
- 18. a local variable in buffer
- 19. a hdata name/variable (the value is automatically converted to string), by default "window" and "buffer" point to current window/buffer.
+ 7. a reversed string (format: "rev:xxx" or "revscr:xxx")
+ 8. a repeated string (format: "repeat:count,string")
+ 9. length of a string (format: "length:xxx" or "lengthscr:xxx")
+ 10. a color (format: "color:xxx", see "Plugin API reference", function "color")
+ 11. a modifier (format: "modifier:name,data,string")
+ 12. an info (format: "info:name,arguments", arguments are optional)
+ 13. a base 16/32/64 encoded/decoded string (format: "base_encode:base,xxx" or "base_decode:base,xxx")
+ 14. current date/time (format: "date" or "date:format")
+ 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. an option (format: "file.section.option")
+ 19. a local variable in buffer
+ 20. 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, for example:
@@ -1371,6 +1372,7 @@ Format for hdata can be one of following:
For name of hdata and variables, please look at "Plugin API reference", function "weechat_hdata_get".
Examples (simple strings):
+ /eval -n ${raw:${info:version}} ==> ${info:version}
/eval -n ${eval_cond:${window.win_width}>100} ==> 1
/eval -n ${info:version} ==> 0.4.3
/eval -n ${env:HOME} ==> /home/user
diff --git a/doc/it/weechat_plugin_api.it.adoc b/doc/it/weechat_plugin_api.it.adoc
index 029a71557..ddffdc528 100644
--- a/doc/it/weechat_plugin_api.it.adoc
+++ b/doc/it/weechat_plugin_api.it.adoc
@@ -2636,6 +2636,13 @@ expanded to last):
|===
| Format | Description | Examples | Results
+// TRANSLATION MISSING
+| `+${raw:xxx}+` +
+ _(WeeChat ≥ 3.1)_ |
+ Raw string (not evaluated). |
+ `+${raw:${info:version}}+` |
+ `+${info:version}+`
+
| `+${name}+` |
Variable `name` from hashtable _extra_vars_. |
`+${name}+` |