From fce5386d5c31c4dbd2d9393f366332eee6464e7a Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?S=C3=A9bastien=20Helleu?= <flashcode@flashtux.org>
Date: Fri, 20 Oct 2023 13:15:07 +0200
Subject: [PATCH] irc: add description for examples in help on some commands
 (issue #2005)

Help is updated on these commands:

- `/allchan`
- `/allpv`
- `/allserv`
---
 src/plugins/irc/irc-command.c | 39 +++++++++++++++++++++++------------
 1 file changed, 26 insertions(+), 13 deletions(-)

diff --git a/src/plugins/irc/irc-command.c b/src/plugins/irc/irc-command.c
index 09b9e289f..39c5a3432 100644
--- a/src/plugins/irc/irc-command.c
+++ b/src/plugins/irc/irc-command.c
@@ -6896,11 +6896,17 @@ irc_command_init ()
             N_("  ${irc_channel.xxx}: variable xxx in channel"),
             "",
             N_("Examples:"),
-            AI("  /allchan /me is testing"),
-            AI("  /allchan -exclude=#weechat hello"),
-            AI("  /allchan -exclude=#weechat,#linux* hello"),
-            AI("  /allchan -include=#linux* hello"),
-            AI("  /allchan -parted /close")),
+            N_("  execute \"/me is testing\" on all channels:"),
+            N_("    /allchan /me is testing"),
+            N_("  say \"hello\" everywhere but not on #weechat:"),
+            N_("    /allchan -exclude=#weechat hello"),
+            N_("  say \"hello\" everywhere but not on #weechat and channels "
+               "beginning with #linux:"),
+            N_("    /allchan -exclude=#weechat,#linux* hello"),
+            N_("  say \"hello\" on all channels beginning with #linux:"),
+            N_("    /allchan -include=#linux* hello"),
+            N_("  close all buffers with parted channels:"),
+            AI("    /allchan -parted /close")),
         "-current|-parted", &irc_command_allchan, NULL, NULL);
     weechat_hook_command (
         "allpv",
@@ -6925,11 +6931,17 @@ irc_command_init ()
             N_("  ${irc_channel.xxx}: variable xxx in channel"),
             "",
             N_("Examples:"),
-            AI("  /allpv /me is testing"),
-            AI("  /allpv -exclude=foo hello"),
-            AI("  /allpv -exclude=foo,bar* hello"),
-            AI("  /allpv -include=bar* hello"),
-            AI("  /allpv /close")),
+            N_("  execute \"/me is testing\" on all private buffers:"),
+            N_("    /allpv /me is testing"),
+            N_("  say \"hello\" everywhere but not for nick foo:"),
+            N_("    /allpv -exclude=foo hello"),
+            N_("  say \"hello\" everywhere but not for nick foo and nicks "
+               "beginning with bar:"),
+            N_("    /allpv -exclude=foo,bar* hello"),
+            N_("  say \"hello\" for all nicks beginning with bar:"),
+            N_("    /allpv -include=bar* hello"),
+            N_("  close all private buffers:"),
+            AI("    /allpv /close")),
         "-current", &irc_command_allpv, NULL, NULL);
     weechat_hook_command (
         "allserv",
@@ -6951,9 +6963,10 @@ irc_command_init ()
             N_("  ${irc_server.xxx}: variable xxx in server"),
             "",
             N_("Examples:"),
-            AI("  /allserv /nick newnick"),
-            AI("  /allserv /away I'm away"),
-            AI("  /allserv /whois $nick")),
+            N_("  change nick on all servers:"),
+            AI("    /allserv /nick newnick"),
+            N_("  do a whois on my nick on all servers:"),
+            AI("    /allserv /whois $nick")),
         NULL, &irc_command_allserv, NULL, NULL);
     weechat_hook_command (
         "auth",