core: add option "-y" in command /buffer, add support of buffers with free content

1 files changed, 33 insertions, 31 deletions

diff --git a/doc/pl/autogen/user/weechat_commands.adoc b/doc/pl/autogen/user/weechat_commands.adoc
index 0391e14fe..95e31cae2 100644
--- a/doc/pl/autogen/user/weechat_commands.adoc
+++ b/doc/pl/autogen/user/weechat_commands.adoc
@@ -640,43 +640,45 @@ Bez argumentów ta komenda wyświetli wszystkie załadowane wtyczki.
 * `+print+`: wyświetl tekst w buforze
 
 ----
-/print  [-buffer <numer>|<nazwa>] [-core] [-escape] [-date <data>] [-tags <tagi>] [-action|-error|-join|-network|-quit] <tekst>
-        -stdout|-stderr <tekst>
+/print  [-buffer <number>|<name>] [-core|-current] [-y <line>] [-escape] [-date <date>] [-tags <tags>] [-action|-error|-join|-network|-quit] [<text>]
+        -stdout|-stderr [<text>]
         -beep
 
--buffer: bufor, w którym zostanie wyświetlony tekst (domyślnie: obecny bufor)
-  -core: alias dla bufora "-buffer core.weechat"
--current: wyświetl tekst w obecnym buforze
--escape: interpretuj znaki poprzedzone \ (na przykład \a, \07, \x07)
-  -date: data wiadomości, możliwe formaty:
-           -n: 'n' sekund wcześniej
-           +n: 'n' sekund później
-            n: 'n' sekund od Epoch (zobacz man time)
-           data/czas (ISO 8601): yyyy-mm-ddThh:mm:ss, przykład: 2014-01-19T04:32:55
-           czas: hh:mm:ss (przykład: 04:32:55)
-  -tags: oddzielona przecinkami lista tagów (zobacz /help filter w celu wyświetlenia listy najczęstszych tagów)
-   tekst: tekst do wyświetlenia (prefiks i wiadomość muszą być oddzielone za pomocą "\t", jeśli tekst zaczyna się od "-" dodaj "\" przed nim)
--stdout: wyświetl tekst na standardowe wyjście (znaki poprzedzone \ są interpretowane)
--stderr: wyświetl tekst na standardowe wyjście błędów (znaki poprzedzone \ są interpretowane)
-   -beep: alias dla "-stderr \a"
-
-Opcje -action ... -quit używają prefiksów zdefiniowanych w opcjach "weechat.look.prefix_*".
-
-Wspierane znaczniki specjalne:
+ -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"
+
+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
 
-Przykłady:
-  wyświetla przypomnienie w buforze głównym z higlightem:
-    /print -core -tags notify_highlight Reminder: kup mleko
-  wyświetla błąd w głównym buforze:
-    /print -core -error Jakiś błąd
-  wyświetla wiadomość w głównym buforze z prefiksem "abc":
-    /print -core abc\tWiadomość
-  wyświetla wiadomość na kanale #weechat:
+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
-  wyświetla bałwana (U+2603):
+  display a snowman (U+2603):
     /print -escape \u2603
-  wysyła alert (BEL):
+  send alert (BEL):
     /print -beep
 ----