core: add options "-newbuffer", "-free" and "-switch" in command /print (issue #1113)

6 files changed, 151 insertions, 133 deletions

diff --git a/doc/de/autogen/user/weechat_commands.adoc b/doc/de/autogen/user/weechat_commands.adoc
index f331fa527..f6b79cf32 100644
--- a/doc/de/autogen/user/weechat_commands.adoc
+++ b/doc/de/autogen/user/weechat_commands.adoc
@@ -640,45 +640,48 @@ Ohne Angabe eines Arguments werden alle installierten Erweiterungen angezeigt.
 * `+print+`: gibt einen Text in einem Buffer aus
 
 ----
-/print  [-buffer <number>|<name>] [-core|-current] [-y <line>] [-escape] [-date <date>] [-tags <tags>] [-action|-error|-join|-network|-quit] [<text>]
+/print  [-buffer <number>|<name>] [-newbuffer <name>] [-free] [-switch] [-core|-current] [-y <line>] [-escape] [-date <date>] [-tags <tags>] [-action|-error|-join|-network|-quit] [<text>]
         -stdout|-stderr [<text>]
         -beep
 
--buffer: Buffer in welchem der Text ausgegeben werden soll (standardmäßig: aktueller Buffer)
-  -core: Alternativname für "-buffer core.weechat"
--current: Text wird im aktuell genutzten Buffer ausgegeben
-      -y: schreibt den Text in die angegebene Zeile (nur bei Buffern mit freiem Inhalt)
-    line: Zeilennummer bei einem Buffer mit freiem Inhalt (erste Zeile ist 0, bei einer negative Zahl wird der Text nach der letzten Zeile eingefügt: -1 = nach der letzten Zeile, -2 = zwei Zeilen, nach der letzten Zeile, ...)
--escape: Escapesequenzen werden umgewandelt (zum Beispiel \a, \07, \x07)
-  -date: Datum der Nachricht, mögliche Formatierung:
-           -n: 'n' vor dem jetzigen Zeipunkt, in Sekunden
-           +n: 'n' in Zukunft, in Sekunden
-            n: 'n' Sekunden seit der Epoche (siehe man time)
-           date/time (ISO 8601): yyyy-mm-ddThh:mm:ss, Beispiel: 2014-01-19T04:32:55
-           time: hh:mm:ss (Beispiel: 04:32:55)
-  -tags: durch Kommata getrennte Liste von Tags (siehe /help filter für eine Liste von Tags die häufig genutzt werden)
-   text: Text der ausgegeben werden soll (Präfix und Nachricht muss durch \t getrennt werden)
--stdout: Text wird an stdout geschickt (Escapesequenzen werden umgewandelt)
--stderr: Text wird an stderr geschickt (Escapesequenzen werden umgewandelt)
-  -beep: Alias für "-stderr \a"
-
-Das Argument -action ... -quit nutzt den Präfix der in der Einstellung "weechat.look.prefix_*" definiert ist.
-
-Folgende Escapesequenzen werden unterstützt:
+   -buffer: display text in this buffer (default: buffer where command is executed)
+-newbuffer: create a new buffer and display text in this buffer
+     -free: create a buffer with free content (with -newbuffer only)
+   -switch: switch to the buffer
+     -core: alias of "-buffer core.weechat"
+  -current: display text on current buffer
+        -y: display on a custom line (for buffer with free content only)
+      line: line number for buffer with free content (first line is 0, a negative number displays after last line: -1 = after last line, -2 = two lines after last line, ...)
+   -escape: interpret escaped chars (for example \a, \07, \x07)
+     -date: message date, format can be:
+              -n: 'n' seconds before now
+              +n: 'n' seconds in the future
+               n: 'n' seconds since the Epoch (see man time)
+              date/time (ISO 8601): yyyy-mm-ddThh:mm:ss, example: 2014-01-19T04:32:55
+              time: hh:mm:ss (example: 04:32:55)
+     -tags: comma-separated list of tags (see /help filter for a list of tags most commonly used)
+      text: text to display (prefix and message must be separated by "\t", if text starts with "-", then add a "\" before)
+   -stdout: display text on stdout (escaped chars are interpreted)
+   -stderr: display text on stderr (escaped chars are interpreted)
+     -beep: alias of "-stderr \a"
+
+The options -action ... -quit use the prefix defined in options "weechat.look.prefix_*".
+
+Following escaped chars are supported:
   \" \\ \a \b \e \f \n \r \t \v \0ooo \xhh \uhhhh \Uhhhhhhhh
 
-Beispiele:
-  zeigt eine Erinnerung, mit Highlight, im Core-Buffer dar:
-    /print -core -tags notify_highlight Reminder: Milch kaufen
-  zeigt eine Fehlernachricht im Core-Buffer an:
-    /print -core -error irgend ein Fehler
-  zeigt eine Nachricht im Core-Buffer mit dem Präfix "abc" an:
-    /print -core abc\tmeine Nachricht
-  es wird eine Nachricht im Channel #weechat ausgegeben:
+Examples:
+  display a reminder on core buffer with a highlight:
+    /print -core -tags notify_highlight Reminder: buy milk
+  display an error on core buffer:
+    /print -core -error Some error here
+  display message on core buffer with prefix "abc":
+    /print -core abc\tThe message
+  display a message on channel #weechat:
     /print -buffer irc.freenode.#weechat Message on #weechat
-  gibt einen Schneemann aus (U+2603):
+  display a snowman (U+2603):
     /print -escape \u2603
-  verschickt Alarm (BEL):
+  send alert (BEL):
     /print -beep
 ----
 
diff --git a/doc/en/autogen/user/weechat_commands.adoc b/doc/en/autogen/user/weechat_commands.adoc
index 5be5de5f7..af4305dd1 100644
--- a/doc/en/autogen/user/weechat_commands.adoc
+++ b/doc/en/autogen/user/weechat_commands.adoc
@@ -640,27 +640,30 @@ Without argument, this command lists loaded plugins.
 * `+print+`: display text on a buffer
 
 ----
-/print  [-buffer <number>|<name>] [-core|-current] [-y <line>] [-escape] [-date <date>] [-tags <tags>] [-action|-error|-join|-network|-quit] [<text>]
+/print  [-buffer <number>|<name>] [-newbuffer <name>] [-free] [-switch] [-core|-current] [-y <line>] [-escape] [-date <date>] [-tags <tags>] [-action|-error|-join|-network|-quit] [<text>]
         -stdout|-stderr [<text>]
         -beep
 
- -buffer: display text in this buffer (default: buffer where command is executed)
-   -core: alias of "-buffer core.weechat"
--current: display text on current buffer
-      -y: display on a custom line (for buffer with free content only)
-    line: line number for buffer with free content (first line is 0, a negative number displays after last line: -1 = after last line, -2 = two lines after last line, ...)
- -escape: interpret escaped chars (for example \a, \07, \x07)
-   -date: message date, format can be:
-            -n: 'n' seconds before now
-            +n: 'n' seconds in the future
-             n: 'n' seconds since the Epoch (see man time)
-            date/time (ISO 8601): yyyy-mm-ddThh:mm:ss, example: 2014-01-19T04:32:55
-            time: hh:mm:ss (example: 04:32:55)
-   -tags: comma-separated list of tags (see /help filter for a list of tags most commonly used)
-    text: text to display (prefix and message must be separated by "\t", if text starts with "-", then add a "\" before)
- -stdout: display text on stdout (escaped chars are interpreted)
- -stderr: display text on stderr (escaped chars are interpreted)
-   -beep: alias of "-stderr \a"
+   -buffer: display text in this buffer (default: buffer where command is executed)
+-newbuffer: create a new buffer and display text in this buffer
+     -free: create a buffer with free content (with -newbuffer only)
+   -switch: switch to the buffer
+     -core: alias of "-buffer core.weechat"
+  -current: display text on current buffer
+        -y: display on a custom line (for buffer with free content only)
+      line: line number for buffer with free content (first line is 0, a negative number displays after last line: -1 = after last line, -2 = two lines after last line, ...)
+   -escape: interpret escaped chars (for example \a, \07, \x07)
+     -date: message date, format can be:
+              -n: 'n' seconds before now
+              +n: 'n' seconds in the future
+               n: 'n' seconds since the Epoch (see man time)
+              date/time (ISO 8601): yyyy-mm-ddThh:mm:ss, example: 2014-01-19T04:32:55
+              time: hh:mm:ss (example: 04:32:55)
+     -tags: comma-separated list of tags (see /help filter for a list of tags most commonly used)
+      text: text to display (prefix and message must be separated by "\t", if text starts with "-", then add a "\" before)
+   -stdout: display text on stdout (escaped chars are interpreted)
+   -stderr: display text on stderr (escaped chars are interpreted)
+     -beep: alias of "-stderr \a"
 
 The options -action ... -quit use the prefix defined in options "weechat.look.prefix_*".
 
diff --git a/doc/fr/autogen/user/weechat_commands.adoc b/doc/fr/autogen/user/weechat_commands.adoc
index 8358223e1..78242df9c 100644
--- a/doc/fr/autogen/user/weechat_commands.adoc
+++ b/doc/fr/autogen/user/weechat_commands.adoc
@@ -640,27 +640,30 @@ Sans paramètre, cette commande liste les extensions chargées.
 * `+print+`: afficher du texte dans un tampon
 
 ----
-/print  [-buffer <numéro>|<nom>] [-core|-current] [-y <ligne>] [-escape] [-date <date>] [-tags <étiquettes>] [-action|-error|-join|-network|-quit] [<texte>]
+/print  [-buffer <numéro>|<nom>] [-newbuffer <nom>] [-free] [-switch] [-core|-current] [-y <ligne>] [-escape] [-date <date>] [-tags <étiquettes>] [-action|-error|-join|-network|-quit] [<texte>]
         -stdout|-stderr [<texte>]
         -beep
 
- -buffer : afficher le texte dans ce tampon (par défaut : tampon où est exécutée la commande)
-   -core : alias de "-buffer core.weechat"
--current : afficher le texte dans le tampon courant
-      -y : afficher sur une ligne personnalisée (pour un tampon avec contenu libre seulement)
-   ligne : numéro de ligne pour un tampon avec contenu libre (la première ligne est 0, un nombre négatif affiche après la dernière ligne : -1 = après la dernière ligne, -2 = deux lignes après la dernière ligne, etc...)
- -escape : interpréter les caractères échappés (par exemple \a, \07, \x07)
-   -date : date du message, le format peut être :
-             -n : 'n' secondes avant maintenant
-             +n : 'n' secondes dans le futur
-              n : 'n' secondes depuis l'époque (voir man time)
-             date/heure (ISO 8601) : yyyy-mm-ddThh:mm:ss, exemple : 2014-01-19T04:32:55
-             heure : hh:mm:ss (exemple : 04:32:55)
-   -tags : liste d'étiquettes séparées par des virgules (voir /help filter pour une liste des étiquettes couramment utilisées)
-   texte : texte à afficher (le préfixe et le message doivent être séparés par "\t", si le texte commence par "-", ajoutez "\" avant)
- -stdout : afficher le texte sur stdout (les caractères échappés sont interprétés)
- -stderr : afficher le texte sur stderr (les caractères échappés sont interprétés)
-   -beep : alias de "-stderr \a"
+   -buffer : afficher le texte dans ce tampon (par défaut : tampon où est exécutée la commande)
+-newbuffer : créer un nouveau tampon et afficher le texte dans ce tampon
+     -free : créer un tampon avec contenu libre (avec -newbuffer seulement)
+   -switch : basculer vers le tampon
+     -core : alias de "-buffer core.weechat"
+  -current : afficher le texte dans le tampon courant
+        -y : afficher sur une ligne personnalisée (pour un tampon avec contenu libre seulement)
+     ligne : numéro de ligne pour un tampon avec contenu libre (la première ligne est 0, un nombre négatif affiche après la dernière ligne : -1 = après la dernière ligne, -2 = deux lignes après la dernière ligne, etc...)
+   -escape : interpréter les caractères échappés (par exemple \a, \07, \x07)
+     -date : date du message, le format peut être :
+               -n : 'n' secondes avant maintenant
+               +n : 'n' secondes dans le futur
+                n : 'n' secondes depuis l'époque (voir man time)
+               date/heure (ISO 8601) : yyyy-mm-ddThh:mm:ss, exemple : 2014-01-19T04:32:55
+               heure : hh:mm:ss (exemple : 04:32:55)
+     -tags : liste d'étiquettes séparées par des virgules (voir /help filter pour une liste des étiquettes couramment utilisées)
+     texte : texte à afficher (le préfixe et le message doivent être séparés par "\t", si le texte commence par "-", ajoutez "\" avant)
+   -stdout : afficher le texte sur stdout (les caractères échappés sont interprétés)
+   -stderr : afficher le texte sur stderr (les caractères échappés sont interprétés)
+     -beep : alias de "-stderr \a"
 
 Les options -action ... -quit utilisent le préfixe défini dans les options "weechat.look.prefix_*".
 
diff --git a/doc/it/autogen/user/weechat_commands.adoc b/doc/it/autogen/user/weechat_commands.adoc
index d4e5e9536..3a7f24faf 100644
--- a/doc/it/autogen/user/weechat_commands.adoc
+++ b/doc/it/autogen/user/weechat_commands.adoc
@@ -640,27 +640,30 @@ Senza argomento, questo comando elenca i plugin caricati.
 * `+print+`: display text on a buffer
 
 ----
-/print  [-buffer <number>|<name>] [-core|-current] [-y <line>] [-escape] [-date <date>] [-tags <tags>] [-action|-error|-join|-network|-quit] [<text>]
+/print  [-buffer <number>|<name>] [-newbuffer <name>] [-free] [-switch] [-core|-current] [-y <line>] [-escape] [-date <date>] [-tags <tags>] [-action|-error|-join|-network|-quit] [<text>]
         -stdout|-stderr [<text>]
         -beep
 
- -buffer: display text in this buffer (default: buffer where command is executed)
-   -core: alias of "-buffer core.weechat"
--current: display text on current buffer
-      -y: display on a custom line (for buffer with free content only)
-    line: line number for buffer with free content (first line is 0, a negative number displays after last line: -1 = after last line, -2 = two lines after last line, ...)
- -escape: interpret escaped chars (for example \a, \07, \x07)
-   -date: message date, format can be:
-            -n: 'n' seconds before now
-            +n: 'n' seconds in the future
-             n: 'n' seconds since the Epoch (see man time)
-            date/time (ISO 8601): yyyy-mm-ddThh:mm:ss, example: 2014-01-19T04:32:55
-            time: hh:mm:ss (example: 04:32:55)
-   -tags: comma-separated list of tags (see /help filter for a list of tags most commonly used)
-    text: text to display (prefix and message must be separated by "\t", if text starts with "-", then add a "\" before)
- -stdout: display text on stdout (escaped chars are interpreted)
- -stderr: display text on stderr (escaped chars are interpreted)
-   -beep: alias of "-stderr \a"
+   -buffer: display text in this buffer (default: buffer where command is executed)
+-newbuffer: create a new buffer and display text in this buffer
+     -free: create a buffer with free content (with -newbuffer only)
+   -switch: switch to the buffer
+     -core: alias of "-buffer core.weechat"
+  -current: display text on current buffer
+        -y: display on a custom line (for buffer with free content only)
+      line: line number for buffer with free content (first line is 0, a negative number displays after last line: -1 = after last line, -2 = two lines after last line, ...)
+   -escape: interpret escaped chars (for example \a, \07, \x07)
+     -date: message date, format can be:
+              -n: 'n' seconds before now
+              +n: 'n' seconds in the future
+               n: 'n' seconds since the Epoch (see man time)
+              date/time (ISO 8601): yyyy-mm-ddThh:mm:ss, example: 2014-01-19T04:32:55
+              time: hh:mm:ss (example: 04:32:55)
+     -tags: comma-separated list of tags (see /help filter for a list of tags most commonly used)
+      text: text to display (prefix and message must be separated by "\t", if text starts with "-", then add a "\" before)
+   -stdout: display text on stdout (escaped chars are interpreted)
+   -stderr: display text on stderr (escaped chars are interpreted)
+     -beep: alias of "-stderr \a"
 
 The options -action ... -quit use the prefix defined in options "weechat.look.prefix_*".
 
diff --git a/doc/ja/autogen/user/weechat_commands.adoc b/doc/ja/autogen/user/weechat_commands.adoc
index f667fae72..3997d5207 100644
--- a/doc/ja/autogen/user/weechat_commands.adoc
+++ b/doc/ja/autogen/user/weechat_commands.adoc
@@ -640,45 +640,48 @@ arguments: ロードするプラグインに与える引数
 * `+print+`: バッファ内にテキストを表示
 
 ----
-/print  [-buffer <number>|<name>] [-core|-current] [-y <line>] [-escape] [-date <date>] [-tags <tags>] [-action|-error|-join|-network|-quit] [<text>]
+/print  [-buffer <number>|<name>] [-newbuffer <name>] [-free] [-switch] [-core|-current] [-y <line>] [-escape] [-date <date>] [-tags <tags>] [-action|-error|-join|-network|-quit] [<text>]
         -stdout|-stderr [<text>]
         -beep
 
- -buffer: 指定したバッファにテキストを表示 (デフォルト: コマンドを実行したバッファ)
-   -core: "-buffer core.weechat" のエイリアス
--current: 現在のバッファにテキストを表示
-      -y: 指定した行番号に表示 (自由内容バッファ専用)
-    line: 自由内容バッファの行番号 (1 行目は 0、負数は最後の行から数えた行: -1 = 最終行から数えて 1 行目、-2 = 最終行から数えて 2 行目、...)
- -escape: エスケープ文字を解釈 (例えば \a、\07、\x07)
-   -date: メッセージの日付、書式:
-            -n: 今から 'n' 秒前
-            +n: 今から 'n' 秒後
-             n: エポックから 'n' 秒目 (man time を参照)
-            日付/時間 (ISO 8601): yyyy-mm-ddThh:mm:ss、例: 2014-01-19T04:32:55
-           時間: hh:mm:ss (example: 04:32:55)
-   -tags: タグのコンマ区切りリスト (よく使うタグのリストは /help filter を参照)
-    text: 表示するテキスト (プレフィックスとメッセージは必ず \t で区切ってください、"-" で始まるテキストは "\" を前置してください)
- -stdout: 標準出力にテキストを表示 (エスケープ文字を解釈)
- -stderr: 標準エラー出力にテキストを表示 (エスケープ文字を解釈)
-   -beep: "-stderr \a" の別名
-
-オプション -action ... -quit をつけた場合、プレフィックスは "weechat.look.prefix_*" で定義されているものになります。
-
-以下のエスケープ文字を使うことができます:
+   -buffer: display text in this buffer (default: buffer where command is executed)
+-newbuffer: create a new buffer and display text in this buffer
+     -free: create a buffer with free content (with -newbuffer only)
+   -switch: switch to the buffer
+     -core: alias of "-buffer core.weechat"
+  -current: display text on current buffer
+        -y: display on a custom line (for buffer with free content only)
+      line: line number for buffer with free content (first line is 0, a negative number displays after last line: -1 = after last line, -2 = two lines after last line, ...)
+   -escape: interpret escaped chars (for example \a, \07, \x07)
+     -date: message date, format can be:
+              -n: 'n' seconds before now
+              +n: 'n' seconds in the future
+               n: 'n' seconds since the Epoch (see man time)
+              date/time (ISO 8601): yyyy-mm-ddThh:mm:ss, example: 2014-01-19T04:32:55
+              time: hh:mm:ss (example: 04:32:55)
+     -tags: comma-separated list of tags (see /help filter for a list of tags most commonly used)
+      text: text to display (prefix and message must be separated by "\t", if text starts with "-", then add a "\" before)
+   -stdout: display text on stdout (escaped chars are interpreted)
+   -stderr: display text on stderr (escaped chars are interpreted)
+     -beep: alias of "-stderr \a"
+
+The options -action ... -quit use the prefix defined in options "weechat.look.prefix_*".
+
+Following escaped chars are supported:
   \" \\ \a \b \e \f \n \r \t \v \0ooo \xhh \uhhhh \Uhhhhhhhh
 
-例:
-  コアバッファにハイライトを付けてリマインダを表示:
+Examples:
+  display a reminder on core buffer with a highlight:
     /print -core -tags notify_highlight Reminder: buy milk
-  コアバッファにエラーを表示:
+  display an error on core buffer:
     /print -core -error Some error here
-  コアバッファにプレフィックス "abc" を付けてメッセージを表示:
+  display message on core buffer with prefix "abc":
     /print -core abc\tThe message
-  チャンネル #weechat にメッセージを表示:
+  display a message on channel #weechat:
     /print -buffer irc.freenode.#weechat Message on #weechat
-  雪だるまを表示 (U+2603):
+  display a snowman (U+2603):
     /print -escape \u2603
-  警告を送信 (BEL):
+  send alert (BEL):
     /print -beep
 ----
 
diff --git a/doc/pl/autogen/user/weechat_commands.adoc b/doc/pl/autogen/user/weechat_commands.adoc
index 95e31cae2..969a523b4 100644
--- a/doc/pl/autogen/user/weechat_commands.adoc
+++ b/doc/pl/autogen/user/weechat_commands.adoc
@@ -640,27 +640,30 @@ Bez argumentów ta komenda wyświetli wszystkie załadowane wtyczki.
 * `+print+`: wyświetl tekst w buforze
 
 ----
-/print  [-buffer <number>|<name>] [-core|-current] [-y <line>] [-escape] [-date <date>] [-tags <tags>] [-action|-error|-join|-network|-quit] [<text>]
+/print  [-buffer <number>|<name>] [-newbuffer <name>] [-free] [-switch] [-core|-current] [-y <line>] [-escape] [-date <date>] [-tags <tags>] [-action|-error|-join|-network|-quit] [<text>]
         -stdout|-stderr [<text>]
         -beep
 
- -buffer: display text in this buffer (default: buffer where command is executed)
-   -core: alias of "-buffer core.weechat"
--current: display text on current buffer
-      -y: display on a custom line (for buffer with free content only)
-    line: line number for buffer with free content (first line is 0, a negative number displays after last line: -1 = after last line, -2 = two lines after last line, ...)
- -escape: interpret escaped chars (for example \a, \07, \x07)
-   -date: message date, format can be:
-            -n: 'n' seconds before now
-            +n: 'n' seconds in the future
-             n: 'n' seconds since the Epoch (see man time)
-            date/time (ISO 8601): yyyy-mm-ddThh:mm:ss, example: 2014-01-19T04:32:55
-            time: hh:mm:ss (example: 04:32:55)
-   -tags: comma-separated list of tags (see /help filter for a list of tags most commonly used)
-    text: text to display (prefix and message must be separated by "\t", if text starts with "-", then add a "\" before)
- -stdout: display text on stdout (escaped chars are interpreted)
- -stderr: display text on stderr (escaped chars are interpreted)
-   -beep: alias of "-stderr \a"
+   -buffer: display text in this buffer (default: buffer where command is executed)
+-newbuffer: create a new buffer and display text in this buffer
+     -free: create a buffer with free content (with -newbuffer only)
+   -switch: switch to the buffer
+     -core: alias of "-buffer core.weechat"
+  -current: display text on current buffer
+        -y: display on a custom line (for buffer with free content only)
+      line: line number for buffer with free content (first line is 0, a negative number displays after last line: -1 = after last line, -2 = two lines after last line, ...)
+   -escape: interpret escaped chars (for example \a, \07, \x07)
+     -date: message date, format can be:
+              -n: 'n' seconds before now
+              +n: 'n' seconds in the future
+               n: 'n' seconds since the Epoch (see man time)
+              date/time (ISO 8601): yyyy-mm-ddThh:mm:ss, example: 2014-01-19T04:32:55
+              time: hh:mm:ss (example: 04:32:55)
+     -tags: comma-separated list of tags (see /help filter for a list of tags most commonly used)
+      text: text to display (prefix and message must be separated by "\t", if text starts with "-", then add a "\" before)
+   -stdout: display text on stdout (escaped chars are interpreted)
+   -stderr: display text on stderr (escaped chars are interpreted)
+     -beep: alias of "-stderr \a"
 
 The options -action ... -quit use the prefix defined in options "weechat.look.prefix_*".