irc: escape/unescape IRC message tags values (issue #1654)

Spec: https://ircv3.net/specs/extensions/message-tags#escaping-values

9 files changed, 82 insertions, 0 deletions

diff --git a/doc/en/weechat_dev.en.adoc b/doc/en/weechat_dev.en.adoc
index 34b7e7358..2c889bcc1 100644
--- a/doc/en/weechat_dev.en.adoc
+++ b/doc/en/weechat_dev.en.adoc
@@ -294,6 +294,7 @@ WeeChat "core" is located in following directories:
 |       irc-redirect.c              | Redirection of IRC command output.
 |       irc-sasl.c                  | SASL authentication with IRC server.
 |       irc-server.c                | I/O communication with IRC server.
+|       irc-tag.c                   | Functions to manipulate IRC message tags.
 |       irc-upgrade.c               | Save/restore of IRC data when upgrading WeeChat.
 |    javascript/                    | JavaScript plugin.
 |       weechat-js.cpp              | Main JavaScript functions (load/unload scripts, execute JavaScript code).
diff --git a/doc/en/weechat_plugin_api.en.adoc b/doc/en/weechat_plugin_api.en.adoc
index dde1f532c..3ce99dbcc 100644
--- a/doc/en/weechat_plugin_api.en.adoc
+++ b/doc/en/weechat_plugin_api.en.adoc
@@ -11837,6 +11837,20 @@ List of modifiers defined by WeeChat and plugins that can be used:
   Message displayed after `/msg` sent to nickserv. |
   Message with hidden password.
 
+| [[hook_modifier_irc_tag_escape_value]] irc_tag_escape_value +
+  _(WeeChat ≥ 3.3)_ |
+  - |
+  Any string. |
+  String with IRC tag value escaped,
+  see: https://ircv3.net/specs/extensions/message-tags#escaping-values.
+
+| [[hook_modifier_irc_tag_unescape_value]] irc_tag_unescape_value +
+  _(WeeChat ≥ 3.3)_ |
+  - |
+  Any string. |
+  String with IRC tag value unescaped,
+  see: https://ircv3.net/specs/extensions/message-tags#escaping-values.
+
 | [[hook_modifier_color_decode_ansi]] color_decode_ansi +
   _(WeeChat ≥ 1.0)_ |
   "1" to keep colors, "0" to remove colors |
diff --git a/doc/fr/weechat_dev.fr.adoc b/doc/fr/weechat_dev.fr.adoc
index cdd807ee3..64b897298 100644
--- a/doc/fr/weechat_dev.fr.adoc
+++ b/doc/fr/weechat_dev.fr.adoc
@@ -296,6 +296,7 @@ Le cœur de WeeChat est situé dans les répertoires suivants :
 |       irc-redirect.c              | Redirection de la sortie des commandes IRC.
 |       irc-sasl.c                  | Authentification SASL avec le serveur IRC.
 |       irc-server.c                | Communication avec le serveur IRC.
+|       irc-tag.c                   | Fonctions pour manipuler les étiquettes de message IRC.
 |       irc-upgrade.c               | Sauvegarde/restauration des données IRC lors de la mise à jour de WeeChat.
 |    javascript/                    | Extension JavaScript.
 |       weechat-js.cpp              | Fonctions principales pour JavaScript (chargement/déchargement des scripts, exécution de code JavaScript).
diff --git a/doc/fr/weechat_plugin_api.fr.adoc b/doc/fr/weechat_plugin_api.fr.adoc
index 7d4c0d92d..5bfe0b2b6 100644
--- a/doc/fr/weechat_plugin_api.fr.adoc
+++ b/doc/fr/weechat_plugin_api.fr.adoc
@@ -12083,6 +12083,20 @@ utilisés :
   Message affiché après `msg` envoyé à nickserv. |
   Message avec le mot de passe caché.
 
+| [[hook_modifier_irc_tag_escape_value]] irc_tag_escape_value +
+  _(WeeChat ≥ 3.3)_ |
+  - |
+  Toute chaîne. |
+  Chaîne avec la valeur de l'étiquette IRC échappée,
+  voir : https://ircv3.net/specs/extensions/message-tags#escaping-values.
+
+| [[hook_modifier_irc_tag_unescape_value]] irc_tag_unescape_value +
+  _(WeeChat ≥ 3.3)_ |
+  - |
+  Toute chaîne. |
+  Chaîne avec la valeur de l'étiquette IRC sans échappements,
+  voir : https://ircv3.net/specs/extensions/message-tags#escaping-values.
+
 | [[hook_modifier_color_decode_ansi]] color_decode_ansi +
   _(WeeChat ≥ 1.0)_ |
   "1" pour garder les couleurs, "0" pour les supprimer |
diff --git a/doc/it/weechat_plugin_api.it.adoc b/doc/it/weechat_plugin_api.it.adoc
index 667c09c38..5618bd8a2 100644
--- a/doc/it/weechat_plugin_api.it.adoc
+++ b/doc/it/weechat_plugin_api.it.adoc
@@ -12304,6 +12304,22 @@ List of modifiers defined by WeeChat and plugins that can be used:
   Message with hidden password.
 
 // TRANSLATION MISSING
+| [[hook_modifier_irc_tag_escape_value]] irc_tag_escape_value +
+  _(WeeChat ≥ 3.3)_ |
+  - |
+  Any string. |
+  String with IRC tag value escaped,
+  see: https://ircv3.net/specs/extensions/message-tags#escaping-values.
+
+// TRANSLATION MISSING
+| [[hook_modifier_irc_tag_unescape_value]] irc_tag_unescape_value +
+  _(WeeChat ≥ 3.3)_ |
+  - |
+  Any string. |
+  String with IRC tag value unescaped,
+  see: https://ircv3.net/specs/extensions/message-tags#escaping-values.
+
+// TRANSLATION MISSING
 | [[hook_modifier_color_decode_ansi]] color_decode_ansi +
   _(WeeChat ≥ 1.0)_ |
   "1" per mantenere i colori, "0" per rimuovere i colori |
diff --git a/doc/ja/weechat_dev.ja.adoc b/doc/ja/weechat_dev.ja.adoc
index 1f0bb8c10..4350df4b1 100644
--- a/doc/ja/weechat_dev.ja.adoc
+++ b/doc/ja/weechat_dev.ja.adoc
@@ -305,6 +305,8 @@ WeeChat "core" は以下のディレクトリに配置されています:
 |       irc-redirect.c              | IRC コマンド出力のリダイレクト
 |       irc-sasl.c                  | IRC サーバに対する SASL 認証
 |       irc-server.c                | IRC サーバとの入出力通信
+// TRANSLATION MISSING
+|       irc-tag.c                   | Functions to manipulate IRC message tags.
 |       irc-upgrade.c               | WeeChat をアップグレードする際の IRC データの保存およびロード
 |    javascript/                    | JavaScript プラグイン
 |       weechat-js.cpp              | JavaScript の主要関数 (スクリプトのロード/アンロード、JavaScript コードの実行)
diff --git a/doc/ja/weechat_plugin_api.ja.adoc b/doc/ja/weechat_plugin_api.ja.adoc
index ea645d493..21bd45ec8 100644
--- a/doc/ja/weechat_plugin_api.ja.adoc
+++ b/doc/ja/weechat_plugin_api.ja.adoc
@@ -11859,6 +11859,22 @@ WeeChat とプラグインが定義する修飾子のリスト:
   `/msg` をサーバに送信した後に表示されるメッセージ |
   パスワードを隠したメッセージ
 
+// TRANSLATION MISSING
+| [[hook_modifier_irc_tag_escape_value]] irc_tag_escape_value +
+  _(WeeChat ≥ 3.3)_ |
+  - |
+  Any string. |
+  String with IRC tag value escaped,
+  see: https://ircv3.net/specs/extensions/message-tags#escaping-values.
+
+// TRANSLATION MISSING
+| [[hook_modifier_irc_tag_unescape_value]] irc_tag_unescape_value +
+  _(WeeChat ≥ 3.3)_ |
+  - |
+  Any string. |
+  String with IRC tag value unescaped,
+  see: https://ircv3.net/specs/extensions/message-tags#escaping-values.
+
 | [[hook_modifier_color_decode_ansi]] color_decode_ansi +
   _(WeeChat バージョン 1.0 以上で利用可)_ |
   色を保持する場合は "1"、削除する場合は "0" |
diff --git a/doc/sr/weechat_dev.sr.adoc b/doc/sr/weechat_dev.sr.adoc
index 988968ea5..456351149 100644
--- a/doc/sr/weechat_dev.sr.adoc
+++ b/doc/sr/weechat_dev.sr.adoc
@@ -290,6 +290,8 @@ WeeChat „језгро” се налази у следећим директо�
 |       irc-redirect.c              | Преусмеравање излаза IRC команде.
 |       irc-sasl.c                  | SASL аутентификација са IRC сервером.
 |       irc-server.c                | У/И комуникација са IRC сервером.
+// TRANSLATION MISSING
+|       irc-tag.c                   | Functions to manipulate IRC message tags.
 |       irc-upgrade.c               | Чување/обнављање IRC података када се ажурира програм WeeChat.
 |    javascript/                    | JavaScript додатак.
 |       weechat-js.cpp              | Главне JavaScript функције (учитавање/уклањање скрипти, извршавање JavaScript кода).
diff --git a/doc/sr/weechat_plugin_api.sr.adoc b/doc/sr/weechat_plugin_api.sr.adoc
index 06fb60e93..829141662 100644
--- a/doc/sr/weechat_plugin_api.sr.adoc
+++ b/doc/sr/weechat_plugin_api.sr.adoc
@@ -11405,6 +11405,22 @@ char *weechat_hook_modifier_exec (const char *modifier,
   Порука која се приказује након што се `/msg` пошаље nickserv боту. |
   Порука са скривеном лозинком.
 
+// TRANSLATION MISSING
+| [[hook_modifier_irc_tag_escape_value]] irc_tag_escape_value +
+  _(WeeChat ≥ 3.3)_ |
+  - |
+  Any string. |
+  String with IRC tag value escaped,
+  see: https://ircv3.net/specs/extensions/message-tags#escaping-values.
+
+// TRANSLATION MISSING
+| [[hook_modifier_irc_tag_unescape_value]] irc_tag_unescape_value +
+  _(WeeChat ≥ 3.3)_ |
+  - |
+  Any string. |
+  String with IRC tag value unescaped,
+  see: https://ircv3.net/specs/extensions/message-tags#escaping-values.
+
 | [[hook_modifier_color_decode_ansi]] color_decode_ansi +
   _(WeeChat ≥ 1.0)_ |
   "1" да се боје задрже, "0" да се боје уклоне |