From ff8beb1918816ccd1c15954f7f564ab02e9cfb9f Mon Sep 17 00:00:00 2001
From: Simon Ser <contact@emersion.fr>
Date: Sun, 27 Jun 2021 09:48:16 +0200
Subject: irc: allow signals "irc_raw_in" and "irc_in" to eat messages (issue
 #1657)

This is useful to implement IRC protocol extensions which introduce
new commands.
---
 doc/sr/weechat_plugin_api.sr.adoc | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

(limited to 'doc/sr/weechat_plugin_api.sr.adoc')

diff --git a/doc/sr/weechat_plugin_api.sr.adoc b/doc/sr/weechat_plugin_api.sr.adoc
index 86f85ccb1..b44d86d42 100644
--- a/doc/sr/weechat_plugin_api.sr.adoc
+++ b/doc/sr/weechat_plugin_api.sr.adoc
@@ -9747,12 +9747,15 @@ struct t_hook *weechat_hook_signal (const char *signal,
   Стринг: листа уклоњених скрипти раздвојених запетама. |
   Уклоњен(а/е) Scheme скрипт(а/е).
 
+// TRANSLATION MISSING
 | irc |
   [[hook_signal_xxx_irc_in_yyy]] xxx,irc_in_yyy ^(1)^ |
   Стринг: порука. |
   IRC порука од сервера (пре него што је употреби irc додатак,
   сигнал се шаље само ако се порука *не* игнорише). +
-  Почевши од верзије 2.2, шаље се комплетна IRC порука, заједно са ознакама.
+  Почевши од верзије 2.2, шаље се комплетна IRC порука, заједно са ознакама. +
+  If the return code of a callback is _WEECHAT_RC_OK_EAT_, then the IRC message
+  is immediately destroyed and not processed by WeeChat.
 
 | irc |
   [[hook_signal_xxx_irc_in2_yyy]] xxx,irc_in2_yyy ^(1)^ |
@@ -9761,13 +9764,16 @@ struct t_hook *weechat_hook_signal (const char *signal,
   сигнал се шаље само ако се порука *не* игнорише). +
   Почевши од верзије 2.2, шаље се комплетна IRC порука, заједно са ознакама.
 
+// TRANSLATION MISSING
 | irc |
   [[hook_signal_xxx_irc_raw_in_yyy]] xxx,irc_raw_in_yyy ^(1)^ +
   _(WeeChat ≥ 0.3.2)_ |
   Стринг: порука. |
   IRC порука од сервера (пре него што је употреби irc додатак,
   сигнал се шаље чак и када се порука игнорише). +
-  Почевши од верзије 2.2, шаље се комплетна IRC порука, заједно са ознакама.
+  Почевши од верзије 2.2, шаље се комплетна IRC порука, заједно са ознакама. +
+  If the return code of a callback is _WEECHAT_RC_OK_EAT_, then the IRC message
+  is immediately destroyed and not processed by WeeChat.
 
 | irc |
   [[hook_signal_xxx_irc_raw_in2_yyy]] xxx,irc_raw_in2_yyy ^(1)^ +
-- 
cgit v1.2.3

