irc: add command /cap (closes #8)

12 files changed, 180 insertions, 6 deletions

diff --git a/doc/de/autogen/user/irc_commands.asciidoc b/doc/de/autogen/user/irc_commands.asciidoc
index 002003a41..c8170d8d7 100644
--- a/doc/de/autogen/user/irc_commands.asciidoc
+++ b/doc/de/autogen/user/irc_commands.asciidoc
@@ -84,6 +84,35 @@ channel: Channelname
 Ohne Angabe von Argumenten wird die Ban-Liste für den aktuellen Channel angezeigt.
 ----
 
+[[command_irc_cap]]
+[command]*`cap`* client capability negotiation::
+
+----
+/cap  ls
+      list
+      req|ack [<capability> [<capability>...]]
+      clear
+      end
+
+   ls: list the capabilities supported by the server
+ list: list the capabilities currently enabled
+  req: request a capability
+  ack: acknowledge capabilities which require client-side acknowledgement
+clear: clear the capabilities currently enabled
+  end: end the capability negotiation
+
+Without argument, "ls" and "list" are sent.
+
+Capabilities supported by WeeChat are: account-notify, away-notify, extended-join, multi-prefix, server-time, userhost-in-names.
+
+The capabilities to automatically enable on servers can be set in option irc.server_default.capabilities (or by server in option irc.server.xxx.capabilities).
+
+Examples:
+   /cap
+   /cap req multi-prefix
+   /cap clear
+----
+
 [[command_irc_connect]]
 [command]*`connect`* Mit IRC-Server(n) verbinden::
 
diff --git a/doc/de/autogen/user/irc_options.asciidoc b/doc/de/autogen/user/irc_options.asciidoc
index 9b518acfc..82e62645e 100644
--- a/doc/de/autogen/user/irc_options.asciidoc
+++ b/doc/de/autogen/user/irc_options.asciidoc
@@ -508,7 +508,7 @@
 ** Werte: 0 .. 1000000 (Standardwert: `25`)
 
 * [[option_irc.server_default.capabilities]] *irc.server_default.capabilities*
-** Beschreibung: `durch Kommata getrennte Liste von erweiterten Client Fähigkeiten ("client capabilities"), welche vom Server angeboten und genutzt werden sollen. Fähigkeiten die von WeeChat unterstützt werden: account-notify, away-notify, extended-join, multi-prefix, server-time, userhost-in-names (Beispiel: "away-notify,multi-prefix")`
+** Beschreibung: `comma-separated list of client capabilities to enable for server if they are available (see /help cap for a list of capabilities supported by WeeChat) (example: "away-notify,multi-prefix")`
 ** Typ: Zeichenkette
 ** Werte: beliebige Zeichenkette (Standardwert: `""`)
 
diff --git a/doc/en/autogen/user/irc_commands.asciidoc b/doc/en/autogen/user/irc_commands.asciidoc
index 0554e74e7..dc988aa6f 100644
--- a/doc/en/autogen/user/irc_commands.asciidoc
+++ b/doc/en/autogen/user/irc_commands.asciidoc
@@ -84,6 +84,35 @@ channel: channel name
 Without argument, this command display ban list for current channel.
 ----
 
+[[command_irc_cap]]
+[command]*`cap`* client capability negotiation::
+
+----
+/cap  ls
+      list
+      req|ack [<capability> [<capability>...]]
+      clear
+      end
+
+   ls: list the capabilities supported by the server
+ list: list the capabilities currently enabled
+  req: request a capability
+  ack: acknowledge capabilities which require client-side acknowledgement
+clear: clear the capabilities currently enabled
+  end: end the capability negotiation
+
+Without argument, "ls" and "list" are sent.
+
+Capabilities supported by WeeChat are: account-notify, away-notify, extended-join, multi-prefix, server-time, userhost-in-names.
+
+The capabilities to automatically enable on servers can be set in option irc.server_default.capabilities (or by server in option irc.server.xxx.capabilities).
+
+Examples:
+   /cap
+   /cap req multi-prefix
+   /cap clear
+----
+
 [[command_irc_connect]]
 [command]*`connect`* connect to IRC server(s)::
 
diff --git a/doc/en/autogen/user/irc_options.asciidoc b/doc/en/autogen/user/irc_options.asciidoc
index a059ffd34..aa7c7f106 100644
--- a/doc/en/autogen/user/irc_options.asciidoc
+++ b/doc/en/autogen/user/irc_options.asciidoc
@@ -508,7 +508,7 @@
 ** values: 0 .. 1000000 (default value: `25`)
 
 * [[option_irc.server_default.capabilities]] *irc.server_default.capabilities*
-** description: `comma-separated list of client capabilities to enable for server if they are available; capabilities supported by WeeChat are: account-notify, away-notify, extended-join, multi-prefix, server-time, userhost-in-names (example: "away-notify,multi-prefix")`
+** description: `comma-separated list of client capabilities to enable for server if they are available (see /help cap for a list of capabilities supported by WeeChat) (example: "away-notify,multi-prefix")`
 ** type: string
 ** values: any string (default value: `""`)
 
diff --git a/doc/fr/autogen/user/irc_commands.asciidoc b/doc/fr/autogen/user/irc_commands.asciidoc
index dc037e3d1..78fc52591 100644
--- a/doc/fr/autogen/user/irc_commands.asciidoc
+++ b/doc/fr/autogen/user/irc_commands.asciidoc
@@ -84,6 +84,35 @@ pseudo : pseudo ou hôte
 Sans paramètre, cette commande affiche la liste des bannissements pour le canal courant.
 ----
 
+[[command_irc_cap]]
+[command]*`cap`* négociation de capacité client::
+
+----
+/cap  ls
+      list
+      req|ack [<capacité> [<capacité>...]]
+      clear
+      end
+
+   ls : lister les capacités supportées par le serveur
+ list : lister les capacités actuellement activées
+  req : demander une capacité
+  ack : accuser réception de capacités qui nécessitent un accusé de réception du client
+clear : effacer les capacités actuellement activées
+  end : terminer la négociation de capacité
+
+Sans paramètre, "ls" et "list" sont envoyés.
+
+Les capacités supportées par WeeChat sont : account-notify, away-notify, extended-join, multi-prefix, server-time, userhost-in-names.
+
+Les capacités à activer automatiquement sur les serveurs peuvent être définies dans l'opion irc.server_default.capabilities (ou par serveur dans l'option irc.server.xxx.capabilities).
+
+Exemples :
+   /cap
+   /cap req multi-prefix
+   /cap clear
+----
+
 [[command_irc_connect]]
 [command]*`connect`* se connecter à un/plusieurs serveur(s) IRC::
 
diff --git a/doc/fr/autogen/user/irc_options.asciidoc b/doc/fr/autogen/user/irc_options.asciidoc
index e759c23fa..76494924a 100644
--- a/doc/fr/autogen/user/irc_options.asciidoc
+++ b/doc/fr/autogen/user/irc_options.asciidoc
@@ -508,7 +508,7 @@
 ** valeurs: 0 .. 1000000 (valeur par défaut: `25`)
 
 * [[option_irc.server_default.capabilities]] *irc.server_default.capabilities*
-** description: `liste séparée par des virgules de capacités client ("client capabilities") à activer sur le serveur si elles sont disponibles ; les capacités supportées par WeeChat sont : account-notify, away-notify, extended-join, multi-prefix, server-time, userhost-in-names (exemple : "away-notify,multi-prefix")`
+** description: `liste séparée par des virgules de capacités client ("client capabilities") à activer sur le serveur si elles sont disponibles (voir /help cap pour la liste des capacités supportées par WeeChat) (exemple : "away-notify,multi-prefix")`
 ** type: chaîne
 ** valeurs: toute chaîne (valeur par défaut: `""`)
 
diff --git a/doc/it/autogen/user/irc_commands.asciidoc b/doc/it/autogen/user/irc_commands.asciidoc
index 5501844d1..230159926 100644
--- a/doc/it/autogen/user/irc_commands.asciidoc
+++ b/doc/it/autogen/user/irc_commands.asciidoc
@@ -84,6 +84,35 @@ channel: channel name
 Without argument, this command display ban list for current channel.
 ----
 
+[[command_irc_cap]]
+[command]*`cap`* client capability negotiation::
+
+----
+/cap  ls
+      list
+      req|ack [<capability> [<capability>...]]
+      clear
+      end
+
+   ls: list the capabilities supported by the server
+ list: list the capabilities currently enabled
+  req: request a capability
+  ack: acknowledge capabilities which require client-side acknowledgement
+clear: clear the capabilities currently enabled
+  end: end the capability negotiation
+
+Without argument, "ls" and "list" are sent.
+
+Capabilities supported by WeeChat are: account-notify, away-notify, extended-join, multi-prefix, server-time, userhost-in-names.
+
+The capabilities to automatically enable on servers can be set in option irc.server_default.capabilities (or by server in option irc.server.xxx.capabilities).
+
+Examples:
+   /cap
+   /cap req multi-prefix
+   /cap clear
+----
+
 [[command_irc_connect]]
 [command]*`connect`* connette ad uno o più server IRC::
 
diff --git a/doc/it/autogen/user/irc_options.asciidoc b/doc/it/autogen/user/irc_options.asciidoc
index f3131db62..1a50a36e6 100644
--- a/doc/it/autogen/user/irc_options.asciidoc
+++ b/doc/it/autogen/user/irc_options.asciidoc
@@ -508,7 +508,7 @@
 ** valori: 0 .. 1000000 (valore predefinito: `25`)
 
 * [[option_irc.server_default.capabilities]] *irc.server_default.capabilities*
-** descrizione: `comma-separated list of client capabilities to enable for server if they are available; capabilities supported by WeeChat are: account-notify, away-notify, extended-join, multi-prefix, server-time, userhost-in-names (example: "away-notify,multi-prefix")`
+** descrizione: `comma-separated list of client capabilities to enable for server if they are available (see /help cap for a list of capabilities supported by WeeChat) (example: "away-notify,multi-prefix")`
 ** tipo: stringa
 ** valori: qualsiasi stringa (valore predefinito: `""`)
 
diff --git a/doc/ja/autogen/user/irc_commands.asciidoc b/doc/ja/autogen/user/irc_commands.asciidoc
index a9c4e29ef..e73d63c42 100644
--- a/doc/ja/autogen/user/irc_commands.asciidoc
+++ b/doc/ja/autogen/user/irc_commands.asciidoc
@@ -84,6 +84,35 @@ channel: チャンネル名
 引数無しの場合は、現在のチャンネルのバンリストを表示。
 ----
 
+[[command_irc_cap]]
+[command]*`cap`* client capability negotiation::
+
+----
+/cap  ls
+      list
+      req|ack [<capability> [<capability>...]]
+      clear
+      end
+
+   ls: list the capabilities supported by the server
+ list: list the capabilities currently enabled
+  req: request a capability
+  ack: acknowledge capabilities which require client-side acknowledgement
+clear: clear the capabilities currently enabled
+  end: end the capability negotiation
+
+Without argument, "ls" and "list" are sent.
+
+Capabilities supported by WeeChat are: account-notify, away-notify, extended-join, multi-prefix, server-time, userhost-in-names.
+
+The capabilities to automatically enable on servers can be set in option irc.server_default.capabilities (or by server in option irc.server.xxx.capabilities).
+
+Examples:
+   /cap
+   /cap req multi-prefix
+   /cap clear
+----
+
 [[command_irc_connect]]
 [command]*`connect`* IRC サーバに接続::
 
diff --git a/doc/ja/autogen/user/irc_options.asciidoc b/doc/ja/autogen/user/irc_options.asciidoc
index d3a1a5660..f03f6dff0 100644
--- a/doc/ja/autogen/user/irc_options.asciidoc
+++ b/doc/ja/autogen/user/irc_options.asciidoc
@@ -508,7 +508,7 @@
 ** 値: 0 .. 1000000 (デフォルト値: `25`)
 
 * [[option_irc.server_default.capabilities]] *irc.server_default.capabilities*
-** 説明: `サーバで利用可能ならば有効化する "client capabilities" のコンマ区切りリスト; WeeChat で利用できる機能: account-notify、away-notify、extended-join、multi-prefix、server-time、userhost-in-names (例: "away-notify,multi-prefix")`
+** 説明: `comma-separated list of client capabilities to enable for server if they are available (see /help cap for a list of capabilities supported by WeeChat) (example: "away-notify,multi-prefix")`
 ** タイプ: 文字列
 ** 値: 未制約文字列 (デフォルト値: `""`)
 
diff --git a/doc/pl/autogen/user/irc_commands.asciidoc b/doc/pl/autogen/user/irc_commands.asciidoc
index 7bfe8ef36..ed15805e2 100644
--- a/doc/pl/autogen/user/irc_commands.asciidoc
+++ b/doc/pl/autogen/user/irc_commands.asciidoc
@@ -84,6 +84,35 @@ kanał: nazwa kanału
 Bez podania argumentu komenda wyświetla listę banów na obecnym kanale.
 ----
 
+[[command_irc_cap]]
+[command]*`cap`* client capability negotiation::
+
+----
+/cap  ls
+      list
+      req|ack [<capability> [<capability>...]]
+      clear
+      end
+
+   ls: list the capabilities supported by the server
+ list: list the capabilities currently enabled
+  req: request a capability
+  ack: acknowledge capabilities which require client-side acknowledgement
+clear: clear the capabilities currently enabled
+  end: end the capability negotiation
+
+Without argument, "ls" and "list" are sent.
+
+Capabilities supported by WeeChat are: account-notify, away-notify, extended-join, multi-prefix, server-time, userhost-in-names.
+
+The capabilities to automatically enable on servers can be set in option irc.server_default.capabilities (or by server in option irc.server.xxx.capabilities).
+
+Examples:
+   /cap
+   /cap req multi-prefix
+   /cap clear
+----
+
 [[command_irc_connect]]
 [command]*`connect`* łączy się z serwerem(ami) IRC::
 
diff --git a/doc/pl/autogen/user/irc_options.asciidoc b/doc/pl/autogen/user/irc_options.asciidoc
index 44b9188ef..c1bfa0928 100644
--- a/doc/pl/autogen/user/irc_options.asciidoc
+++ b/doc/pl/autogen/user/irc_options.asciidoc
@@ -508,7 +508,7 @@
 ** wartości: 0 .. 1000000 (domyślna wartość: `25`)
 
 * [[option_irc.server_default.capabilities]] *irc.server_default.capabilities*
-** opis: `oddzielona przecinkami lista opcji klienta do włączenia dla serwera, jeśli są dostępne; opcje wspierane przez WeeChat: account-notify, away-notify, extended-join, multi-prefix, server-time, userhost-in-names (przykład: "away-notify,multi-prefix")`
+** opis: `comma-separated list of client capabilities to enable for server if they are available (see /help cap for a list of capabilities supported by WeeChat) (example: "away-notify,multi-prefix")`
 ** typ: ciąg
 ** wartości: dowolny ciąg (domyślna wartość: `""`)