From 42a0a19828e223fd3ec3ed789f8b6a80e9cd8215 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=A9bastien=20Helleu?= Date: Sat, 25 Jun 2022 08:53:18 +0200 Subject: doc/user: add a chapter on supported IRCv3 extensions --- doc/pl/weechat_user.pl.adoc | 273 +++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 272 insertions(+), 1 deletion(-) (limited to 'doc/pl/weechat_user.pl.adoc') diff --git a/doc/pl/weechat_user.pl.adoc b/doc/pl/weechat_user.pl.adoc index b38006387..f3e392da8 100644 --- a/doc/pl/weechat_user.pl.adoc +++ b/doc/pl/weechat_user.pl.adoc @@ -3357,6 +3357,277 @@ który może być ustawiony na przykład na `~/.weechat`. Więcej informacji można znaleźć pod adresem: https://www.oftc.net/NickServ/CertFP/ +// TRANSLATION MISSING +[[irc_ircv3_support]] +==== IRCv3 support + +WeeChat supports the following https://ircv3.net/irc/[IRCv3 extensions]: + +* <> +* <> +* <> +* <> +* <> +* <> +* <> +* <> +* <> +* <> +* <> +* <> +* <> +* <> +* <> +* <> + +By default all capabilities supported by the server and WeeChat are +automatically enabled +(see option <>). + +Tables with comparison of different IRC clients, including WeeChat, are available +on this page: https://ircv3.net/software/clients. + +[[irc_ircv3_account_notify]] +===== account-notify + +Specification: https://ircv3.net/specs/extensions/account-notify + +This capability allows the server to send messages when users identify or +unidentify on the server. + +WeeChat displays such messages if the option +<> +is enabled (default value). + +Examples: + +.... +-- alice zidentyfikował się jako Alice01 + +-- alice został niezidentyfikowany +.... + +[[irc_ircv3_account_tag]] +===== account-tag + +Specification: https://ircv3.net/specs/extensions/account-tag + +This capability allows the server to send account as message tag to commands +sent to the client. + +WeeChat parses this tag and saves it in the message, but it is not used or +displayed. It can be used in <> command to filter +messages matching specific accounts. + +Example of raw IRC message received: + +.... +@account=Alice01 :user@example.com PRIVMSG #test :Hello! +.... + +Message displayed in channel: + +.... + Hello! +.... + +Message with tags: + +.... + Hello! [irc_privmsg,irc_tag_account_Alice01,notify_message,prefix_nick_lightcyan,nick_alice,host_user@example.com,log1] +.... + +[[irc_ircv3_away_notify]] +===== away-notify + +Specification: https://ircv3.net/specs/extensions/away-notify + +This capability allows the server to send away notifications for users present +on the same channels as you. + +When the away status is changed for a user (away or back), this is reflected +with a specific color in the nicklist, using the following options: + +* <> +* <> +* <> + +[[irc_ircv3_cap_notify]] +===== cap-notify + +Specification: https://ircv3.net/specs/extensions/capability-negotiation#the-cap-new-subcommand + +This capability allows the server to advertise on new or removed capabilities +on the server (via `CAP NEW` and `CAP DEL` commands). + +Examples: + +.... +-- irc: możliwości klienta, teraz dostępne: sasl + +-- irc: możliwości klienta, usunięte: sasl +.... + +[[irc_ircv3_chghost]] +===== chghost + +Specification: https://ircv3.net/specs/extensions/chghost + +This capability allows the server to send messages when users change name or host. + +When the option <> +is enabled (default value), the host changes are automatically hidden if the nick +has not spoken for several minutes. + +The color of the change host message is controlled by the option +<>. + +Example: + +.... +-- alice (user@example.com) zmienił hosta na test.com +.... + +[[irc_ircv3_extended_join]] +===== extended-join + +Specification: https://ircv3.net/specs/extensions/extended-join + +This capability allows the server to send account and real name when users +join channels. + +WeeChat displays this additional information in join messages if the option +<> +is enabled (default value). + +Example: + +.... +--> john [John01] (John Doe) (~user@example.com) wszedł na #test +.... + +[[irc_ircv3_invite_notify]] +===== invite-notify + +Specification: https://ircv3.net/specs/extensions/invite-notify + +This capability allows the server to send invite messages when users are +invited to channels. + +Example: + +.... +-- alice zaprosił bob na #test +.... + +[[irc_ircv3_message_tags]] +===== message-tags + +Specification: https://ircv3.net/specs/extensions/message-tags + +This capability allows to add metadata in messages. + +These tags can be displayed using the command `/debug tags`. + +It must be enabled to use <>. + +[[irc_ircv3_monitor]] +===== monitor + +Specification: https://ircv3.net/specs/extensions/monitor + +This capability allows the server to send notifications when clients become +online/offline. + +WeeChat automatically uses this extension if available when using the +<> command. + +[[irc_ircv3_multi_prefix]] +===== multi-prefix + +Specification: https://ircv3.net/specs/extensions/multi-prefix + +This capability allows the server to send all user modes at once in +<> and <> responses. + + +//// +Example: output of `/names`: + +.... +-- Nicki #test: [@%+alice bob +carol] +.... +//// + +[NOTE] +For now, WeeChat doesn't display all prefixes in the `/names` output, even if +they are received and properly saved internally. + +Example: output of `/whois alice`: + +.... +-- [alice] @%+#test +.... + +[[irc_ircv3_sasl]] +===== SASL + +Specification: https://ircv3.net/specs/extensions/sasl-3.2 + +See the dedicated chapter <>. + +[[irc_ircv3_server_time]] +===== server-time + +Specification: https://ircv3.net/specs/extensions/server-time + +This capability allows the server to send time for messages as message tag. + +When the time is received in a message, WeeChat uses it to display the message +(it can then be displayed with a past date). + +The <> in Relay plugin supports this capability, +so any IRC client of Relay should enable it to display the real message time +in the backlog sent upon connection. + +[[irc_ircv3_setname]] +===== setname + +Specification: https://ircv3.net/specs/extensions/setname + +This capability lets you change your real name by using the +<> command. + +[[irc_ircv3_typing]] +===== typing + +Specification: https://ircv3.net/specs/client-tags/typing + +See the dedicated chapter <>. + +[[irc_ircv3_userhost_in_names]] +===== userhost-in-names + +Specification: https://ircv3.net/specs/extensions/userhost-in-names + +This capability allows the server to send hostnames in <> +responses. + +[NOTE] +WeeChat doesn't display hostnames in the `/names` output. + +Example of raw IRC messages received without the capability: + +.... +:irc.server 353 alice = #test :@alice bob +carol +.... + +Example of raw IRC messages received with the capability: + +.... +:irc.server 353 alice = #test :@alice!user1@host1 bob!user2@host2 +carol!user3@host3 +.... + +[[irc_ircv3_whox]] +===== WHOX + +Specification: https://ircv3.net/specs/extensions/whox + +This capability lets you request additional fields in the WHO response +(via the <> command). + +WeeChat displays all additional information received in the WHO output. + [[irc_sasl_authentication]] ==== Uwierzytelnianie SASL @@ -3880,7 +4151,7 @@ Jest używana przez wtyczkę IRC na kanałach i w prywatnych buforach, kiedy serwer posiada włączoną opcję "message-tags" (możesz to sprawdzić komendą <>). + Pod spodem, używany jest tag klienta "typing" zgodnie z tą specyfikacją: -https://ircv3.net/specs/client-tags/typing.html. +https://ircv3.net/specs/client-tags/typing. [[typing_activation]] === Aktywacja -- cgit v1.2.3