api: allow negative value for y in function printf_y

ChangeLog.asciidoc

@@ -51,6 +51,7 @@ http://weechat.org/files/releasenotes/ReleaseNotes-devel.html[release notes]
 * core: add signals "key_combo_{default|search|cursor}"
 * core: display a warning in case of inconsistency between the options
   weechat.look.save_{config|layout}_on_exit
+* api: allow negative value for y in function printf_y
 * api: add support of case insensitive search and search by buffer full name
   in function buffer_search (bug #34318)
 * api: add option "detached" in function hook_process_hashtable

doc/en/weechat_plugin_api.en.txt

@@ -6588,7 +6588,10 @@ void weechat_printf_y (struct t_gui_buffer *buffer, int y,
 Arguments:
 
 * 'buffer': buffer pointer
-* 'y': line number (first line is 0)
+* 'y': line number (first line is 0); a negative value adds a line after last
+  line displayed: absolute value of 'y' is the number of lines after last line
+  (for example -1 is immediately after last line, -2 is 2 lines after last line)
+  _(WeeChat ≥ 0.4.4)_
 * 'message': message to display
 
 C example:

doc/fr/weechat_plugin_api.fr.txt

@@ -6689,7 +6689,11 @@ void weechat_printf_y (struct t_gui_buffer *buffer, int y,
 Paramètres :
 
 * 'buffer' : pointeur vers le tampon
-* 'y' : numéro de ligne (la première ligne est 0)
+* 'y' : numéro de ligne (la première ligne est 0); une valeur négative affiche
+  une ligne après la dernière ligne affichée: la valeur absolue de 'y' est le
+  nombre de lignes après la dernière ligne (par exemple -1 est immédiatement
+  après la dernière ligne, -2 est 2 lignes après la dernière ligne)
+  _(WeeChat ≥ 0.4.4)_
 * 'message' : message à afficher
 
 Exemple en C :

doc/it/weechat_plugin_api.it.txt

@@ -6685,7 +6685,11 @@ void weechat_printf_y (struct t_gui_buffer *buffer, int y,
 Argomenti:
 
 * 'buffer': puntatore al buffer
-* 'y': numero di riga (la prima riga è 0)
+// TRANSLATION MISSING
+* 'y': numero di riga (la prima riga è 0); a negative value adds a line after
+  last line displayed: absolute value of 'y' is the number of lines after last
+  line (for example -1 is immediately after last line, -2 is 2 lines after last
+  line) _(WeeChat ≥ 0.4.4)_
 * 'message': messaggio da visualizzare
 
 Esempio in C:

doc/ja/weechat_plugin_api.ja.txt

@@ -6594,7 +6594,11 @@ void weechat_printf_y (struct t_gui_buffer *buffer, int y,
 引数:
 
 * 'buffer': バッファへのポインタ
-* 'y': 行番号 (1 行目は 0)
+// TRANSLATION MISSING
+* 'y': 行番号 (1 行目は 0); a negative value adds a line after last line
+  displayed: absolute value of 'y' is the number of lines after last line (for
+  example -1 is immediately after last line, -2 is 2 lines after last line)
+  _(WeeChat バージョン 0.4.4 以上で利用可)_
 * 'message': 表示するメッセージ
 
 C 言語での使用例:

src/gui/gui-chat.c

@@ -863,7 +863,7 @@ gui_chat_printf_y (struct t_gui_buffer *buffer, int y, const char *message, ...)
     /* no message: delete line */
     if (!vbuffer[0])
     {
-        if (gui_init_ok)
+        if (gui_init_ok && (y >= 0))
         {
             for (ptr_line = buffer->own_lines->first_line; ptr_line;
                  ptr_line = ptr_line->next_line)
@@ -885,6 +885,13 @@ gui_chat_printf_y (struct t_gui_buffer *buffer, int y, const char *message, ...)
     {
         if (gui_init_ok)
         {
+            /* if y is negative, add a line -N lines after the last line */
+            if (y < 0)
+            {
+                y = (buffer->own_lines && buffer->own_lines->last_line) ?
+                    buffer->own_lines->last_line->data->y - y : (-1 * y) - 1;
+            }
+            /* compute the number of lines to add before y */
             if (buffer->own_lines && buffer->own_lines->last_line)
                 num_lines_to_add = y - buffer->own_lines->last_line->data->y - 1;
             else