summaryrefslogtreecommitdiff
path: root/doc/fr/weechat_user.fr.adoc
diff options
context:
space:
mode:
authorSébastien Helleu <flashcode@flashtux.org>2023-05-05 20:38:38 +0200
committerSébastien Helleu <flashcode@flashtux.org>2023-05-14 15:32:39 +0200
commit176a10677137e887ed5e8299669bacbc4148d65a (patch)
treefd27d7d932c80eb3bec59a17ccbc9bd3a15a0eed /doc/fr/weechat_user.fr.adoc
parente8b5d73421f63e6e792c039e7a86754db8cfa78c (diff)
downloadweechat-176a10677137e887ed5e8299669bacbc4148d65a.zip
irc: add support of capability "draft/multiline" (closes #1923)
Diffstat (limited to 'doc/fr/weechat_user.fr.adoc')
-rw-r--r--doc/fr/weechat_user.fr.adoc60
1 files changed, 60 insertions, 0 deletions
diff --git a/doc/fr/weechat_user.fr.adoc b/doc/fr/weechat_user.fr.adoc
index f74720696..3dd5254a7 100644
--- a/doc/fr/weechat_user.fr.adoc
+++ b/doc/fr/weechat_user.fr.adoc
@@ -3512,6 +3512,7 @@ WeeChat supporte les https://ircv3.net/irc/[extensions IRCv3 ^↗^,window=_blan
* <<irc_ircv3_batch,batch>>
* <<irc_ircv3_cap_notify,cap-notify>>
* <<irc_ircv3_chghost,chghost>>
+* <<irc_ircv3_draft/multiline,draft/multiline>>
* <<irc_ircv3_extended_join,extended-join>>
* <<irc_ircv3_invite_notify,invite-notify>>
* <<irc_ircv3_message_tags,message-tags>>
@@ -3641,6 +3642,65 @@ Exemple :
-- alice (user@example.com) a changé d'hôte pour test.com
....
+[[irc_ircv3_draft_multiline]]
+===== draft/multiline
+
+Spécification : https://ircv3.net/specs/extensions/multiline[multiline ^↗^,window=_blank]
+
+Cette capacité autorise le client et le serveur à envoyer des messages avec
+plusieurs lignes, en utilisant la capacité <<irc_ircv3_batch,batch>>, qui doit
+être activée également.
+
+Il y a des limites en terme d'octets ou nombre de lignes dans un message
+multi-lignes qui sont données dans la capacité envoyée par le serveur,
+par exemple :
+
+....
+CAP alice LS * :draft/multiline=max-bytes=4096,max-lines=24
+....
+
+Cela fixe la limite à 4096 octets et 24 lignes pour un contenu "batch"
+multi-lignes.
+
+Si les limites ne sont pas envoyées par le serveur, celles par défaut dans
+WeeChat sont :
+
+* max octets : 4096
+* max lignes : 24
+
+Seuls les messages standards et ceux envoyés avec la commande
+<<command_irc_notice,/notice>> peuvent être multi-lignes. +
+Les messages ACTION CTCP envoyés par avec la commande <<command_irc_me,/me>>
+ne sont pas affectés par cette capacité. Cela signifie que les actions
+multi-lignes sont envoyées sous forme de plusieurs actions.
+
+[WARNING]
+Comme la spécification est un brouillon (« draft »), elle peut changer et le
+support "multiline" peut être cassé à tout moment dans WeeChat. +
+La capacité est automatiquement activée si le serveur la supporte et peut être
+désactivée avec cette commande :
+`/set irc.server_default.capabilities "*,!draft/multiline"`. +
+Lorsque la capacité est désactivée, un message multi-lignes est envoyé sous
+forme de plusieurs messages, comme s'ils avaient été envoyés séquentiellement
+au serveur.
+
+Exemple de messages IRC envoyés pour un message utilisateur avec deux lignes
+(`ceci est un test` / `sur deux lignes`), envoyé au canal #test :
+
+....
+BATCH +i8Je7M7gquddoyC9 draft/multiline #test
+@batch=i8Je7M7gquddoyC9 PRIVMSG #test :ceci est un test
+@batch=i8Je7M7gquddoyC9 PRIVMSG #test :sur deux lignes
+BATCH -i8Je7M7gquddoyC9
+....
+
+Affichage du message envoyé dans WeeChat :
+
+....
+19:01:45 alice | ceci est un test
+ | sur deux lignes
+....
+
[[irc_ircv3_extended_join]]
===== extended-join