core: add bar option "color_bg_inactive" (issue #732)

10 files changed, 126 insertions, 8 deletions

diff --git a/doc/de/weechat_scripting.de.adoc b/doc/de/weechat_scripting.de.adoc
index 815bb5e98..84dc3c572 100644
--- a/doc/de/weechat_scripting.de.adoc
+++ b/doc/de/weechat_scripting.de.adoc
@@ -168,6 +168,17 @@ Weechat.config_new_option(config, section, "name", "string", "description of opt
                           "value", "value", 0, ["check_cb", "", "change_cb", "", "delete_cb", ""])
 ----
 
+// TRANSLATION MISSING
+And the function `+Weechat.bar_new+` receives the colors in an array of 4 strings
+(color_fg, color_delim, color_bg, color_bg_inactive), so a call to this function
+looks like:
+
+[source,ruby]
+----
+Weechat.bar_new("name", "off", "0", "window", "", "left", "vertical", "vertical", "0", "0",
+                ["default", "default", "default", "default"], "0", "items")
+----
+
 ==== Lua
 
 ===== Funktionen
diff --git a/doc/en/weechat_plugin_api.en.adoc b/doc/en/weechat_plugin_api.en.adoc
index b6bbddb37..d60de708f 100644
--- a/doc/en/weechat_plugin_api.en.adoc
+++ b/doc/en/weechat_plugin_api.en.adoc
@@ -14615,6 +14615,8 @@ bar = weechat.bar_search("mybar")
 
 ==== bar_new
 
+_Updated in 2.9._
+
 Create a new bar.
 
 Prototype:
@@ -14634,6 +14636,7 @@ struct t_gui_bar *weechat_bar_new (const char *name,
                                    const char *color_fg,
                                    const char *color_delim,
                                    const char *color_bg,
+                                   const char *color_bg_inactive,
                                    const char *separator,
                                    const char *items);
 ----
@@ -14670,6 +14673,8 @@ Arguments:
 * _color_fg_: color for text in bar
 * _color_delim_: color for delimiters in bar
 * _color_bg_: background color for bar
+* _color_bg_inactive_: background color for window bar which is not displayed
+  in active window
 * _separator_:
 ** _on_: bar has separator line with other windows/bars
 ** _off_: no separator
@@ -14697,6 +14702,7 @@ struct t_gui_bar *my_bar = weechat_bar_new ("mybar",
                                             "default",
                                             "cyan",
                                             "blue",
+                                            "darkgray",
                                             "off",
                                             "time,buffer_number+buffer_name");
 ----
@@ -14708,13 +14714,19 @@ Script (Python):
 # prototype
 bar = weechat.bar_new(name, hidden, priority, type, condition, position,
     filling_top_bottom, filling_left_right, size, size_max,
-    color_fg, color_delim, color_bg, separator, items)
+    color_fg, color_delim, color_bg, color_bg_inactive, separator, items)
 
 # example
 bar = weechat.bar_new("mybar", "off", "100", "window", "", "top", "horizontal", "vertical",
-    "0", "5", "default", "cyan", "blue", "off", "time,buffer_number+buffer_name")
+    "0", "5", "default", "cyan", "blue", "darkgray", "off", "time,buffer_number+buffer_name")
 ----
 
+[NOTE]
+With WeeChat ≥ 2.9, in Ruby, the 4 colors (color_fg, color_delim, color_bg,
+color_bg_inactive) must be given in an array of 4 strings (due to a Ruby
+limitation of 15 arguments by function), see the
+link:++weechat_scripting.en.html#_ruby++[WeeChat scripting guide] for more info.
+
 ==== bar_set
 
 Set a new value for a bar property.
diff --git a/doc/en/weechat_scripting.en.adoc b/doc/en/weechat_scripting.en.adoc
index 2c9bbd330..1c57349f2 100644
--- a/doc/en/weechat_scripting.en.adoc
+++ b/doc/en/weechat_scripting.en.adoc
@@ -158,6 +158,16 @@ Weechat.config_new_option(config, section, "name", "string", "description of opt
                           "value", "value", 0, ["check_cb", "", "change_cb", "", "delete_cb", ""])
 ----
 
+And the function `+Weechat.bar_new+` receives the colors in an array of 4 strings
+(color_fg, color_delim, color_bg, color_bg_inactive), so a call to this function
+looks like:
+
+[source,ruby]
+----
+Weechat.bar_new("name", "off", "0", "window", "", "left", "vertical", "vertical", "0", "0",
+                ["default", "default", "default", "default"], "0", "items")
+----
+
 ==== Lua
 
 ===== Functions
diff --git a/doc/fr/weechat_plugin_api.fr.adoc b/doc/fr/weechat_plugin_api.fr.adoc
index bf62a10ae..6f0b3251b 100644
--- a/doc/fr/weechat_plugin_api.fr.adoc
+++ b/doc/fr/weechat_plugin_api.fr.adoc
@@ -14922,6 +14922,8 @@ bar = weechat.bar_search("mybar")
 
 ==== bar_new
 
+_Mis à jour dans la 2.9._
+
 Créer une nouvelle barre.
 
 Prototype :
@@ -14941,6 +14943,7 @@ struct t_gui_bar *weechat_bar_new (const char *name,
                                    const char *color_fg,
                                    const char *color_delim,
                                    const char *color_bg,
+                                   const char *color_bg_inactive,
                                    const char *separator,
                                    const char *items);
 ----
@@ -14987,6 +14990,8 @@ Paramètres :
 * _color_fg_ : couleur du texte dans la barre
 * _color_delim_ : couleur pour les délimiteurs dans la barre
 * _color_bg_ : couleur de fond pour la barre
+* _color_bg_inactive_ : couleur de fond pour une barre de type "window" qui
+  n'est pas affichée dans la fenêtre active
 * _separator_ :
 ** _on_ : la barre a un séparateur avec les autres fenêtres/barres
 ** _off_ : pas de séparateur
@@ -15014,6 +15019,7 @@ struct t_gui_bar *my_bar = weechat_bar_new ("mybar",
                                             "default",
                                             "cyan",
                                             "blue",
+                                            "darkgray",
                                             "off",
                                             "time,buffer_number+buffer_name");
 ----
@@ -15025,13 +15031,20 @@ Script (Python) :
 # prototype
 bar = weechat.bar_new(name, hidden, priority, type, condition, position,
     filling_top_bottom, filling_left_right, size, size_max,
-    color_fg, color_delim, color_bg, separator, items)
+    color_fg, color_delim, color_bg, color_bg_inactive, separator, items)
 
 # exemple
 bar = weechat.bar_new("mybar", "off", "100", "window", "", "top", "horizontal", "vertical",
-    "0", "5", "default", "cyan", "blue", "off", "time,buffer_number+buffer_name")
+    "0", "5", "default", "cyan", "blue", "darkgray", "off", "time,buffer_number+buffer_name")
 ----
 
+[NOTE]
+Avec WeeChat ≥ 2.9, en Ruby, les 4 couleurs (color_fg, color_delim, color_bg,
+color_bg_inactive) doivent être données dans un tableau de 4 chaînes de caractères
+(en raison d'une limitation de Ruby à 15 paramètres par fonction), voir le
+link:++weechat_scripting.fr.html#_ruby++[Guide pour scripts WeeChat] pour plus
+d'infos.
+
 ==== bar_set
 
 Affecter une nouvelle valeur pour une propriété de la barre.
diff --git a/doc/fr/weechat_scripting.fr.adoc b/doc/fr/weechat_scripting.fr.adoc
index d7bbb10b7..b42e29d14 100644
--- a/doc/fr/weechat_scripting.fr.adoc
+++ b/doc/fr/weechat_scripting.fr.adoc
@@ -168,6 +168,16 @@ Weechat.config_new_option(config, section, "name", "string", "description of opt
                           "value", "value", 0, ["check_cb", "", "change_cb", "", "delete_cb", ""])
 ----
 
+Et la fonction `+Weechat.bar_new+` reçoit les couleurs dans un tableau de 4
+chaînes de caractères (color_fg, color_delim, color_bg, color_bg_inactive),
+donc un appel à cette fonction ressemble à ceci :
+
+[source,ruby]
+----
+Weechat.bar_new("name", "off", "0", "window", "", "left", "vertical", "vertical", "0", "0",
+                ["default", "default", "default", "default"], "0", "items")
+----
+
 ==== Lua
 
 ===== Fonctions
diff --git a/doc/it/weechat_plugin_api.it.adoc b/doc/it/weechat_plugin_api.it.adoc
index 9ebed0c14..b34bf0116 100644
--- a/doc/it/weechat_plugin_api.it.adoc
+++ b/doc/it/weechat_plugin_api.it.adoc
@@ -15197,6 +15197,9 @@ bar = weechat.bar_search("mybar")
 
 ==== bar_new
 
+// TRANSLATION MISSING
+_Updated in 2.9._
+
 Crea una nuova barra.
 
 Prototipo:
@@ -15216,6 +15219,7 @@ struct t_gui_bar *weechat_bar_new (const char *name,
                                    const char *color_fg,
                                    const char *color_delim,
                                    const char *color_bg,
+                                   const char *color_bg_inactive,
                                    const char *separator,
                                    const char *items);
 ----
@@ -15263,6 +15267,9 @@ Argomenti:
 * _color_fg_: colore per il testo nella barra
 * _color_delim_: colore per i delimitatori nella barra
 * _color_bg_: colore di sfondo per la barra
+// TRANSLATION MISSING
+* _color_bg_inactive_: background color for window bar which is not displayed
+  in active window
 * _separator_:
 ** _on_: la barra ha una riga di separazione con altre finestre/barre
 ** _off_: nessun separatore
@@ -15290,6 +15297,7 @@ struct t_gui_bar *my_bar = weechat_bar_new ("mybar",
                                             "default",
                                             "cyan",
                                             "blue",
+                                            "darkgray",
                                             "off",
                                             "time,buffer_number+buffer_name");
 ----
@@ -15301,13 +15309,20 @@ Script (Python):
 # prototipo
 bar = weechat.bar_new(name, hidden, priority, type, condition, position,
     filling_top_bottom, filling_left_right, size, size_max,
-    color_fg, color_delim, color_bg, separator, items)
+    color_fg, color_delim, color_bg, color_bg_inactive, separator, items)
 
 # esempio
 bar = weechat.bar_new("mybar", "off", "100", "window", "", "top", "horizontal", "vertical",
-    "0", "5", "default", "cyan", "blue", "off", "time,buffer_number+buffer_name")
+    "0", "5", "default", "cyan", "blue", "darkgray", "off", "time,buffer_number+buffer_name")
 ----
 
+// TRANSLATION MISSING
+[NOTE]
+With WeeChat ≥ 2.9, in Ruby, the 4 colors (color_fg, color_delim, color_bg,
+color_bg_inactive) must be given in an array of 4 strings (due to a Ruby
+limitation of 15 arguments by function), see the
+link:++weechat_scripting.en.html#_ruby++[WeeChat scripting guide] for more info.
+
 ==== bar_set
 
 Imposta un nuovo valore per la proprietà di una barra.
diff --git a/doc/it/weechat_scripting.it.adoc b/doc/it/weechat_scripting.it.adoc
index b9e64a56f..21d8f5795 100644
--- a/doc/it/weechat_scripting.it.adoc
+++ b/doc/it/weechat_scripting.it.adoc
@@ -173,6 +173,17 @@ Weechat.config_new_option(config, section, "name", "string", "description of opt
                           "value", "value", 0, ["check_cb", "", "change_cb", "", "delete_cb", ""])
 ----
 
+// TRANSLATION MISSING
+And the function `+Weechat.bar_new+` receives the colors in an array of 4 strings
+(color_fg, color_delim, color_bg, color_bg_inactive), so a call to this function
+looks like:
+
+[source,ruby]
+----
+Weechat.bar_new("name", "off", "0", "window", "", "left", "vertical", "vertical", "0", "0",
+                ["default", "default", "default", "default"], "0", "items")
+----
+
 ==== Lua
 
 // TRANSLATION MISSING
diff --git a/doc/ja/weechat_plugin_api.ja.adoc b/doc/ja/weechat_plugin_api.ja.adoc
index cba0bc1cc..661303008 100644
--- a/doc/ja/weechat_plugin_api.ja.adoc
+++ b/doc/ja/weechat_plugin_api.ja.adoc
@@ -14612,6 +14612,8 @@ bar = weechat.bar_search("mybar")
 
 ==== bar_new
 
+_WeeChat バージョン 2.9 で更新。_
+
 新しいバーを作成。
 
 プロトタイプ:
@@ -14631,6 +14633,7 @@ struct t_gui_bar *weechat_bar_new (const char *name,
                                    const char *color_fg,
                                    const char *color_delim,
                                    const char *color_bg,
+                                   const char *color_bg_inactive,
                                    const char *separator,
                                    const char *items);
 ----
@@ -14665,6 +14668,9 @@ struct t_gui_bar *weechat_bar_new (const char *name,
 * _size_: バーのサイズ、文字単位 (0 は自動サイズ)
 * _size_max_: バーの最大サイズ (0 は最大サイズが指定されていない)
 * _color_fg_: バーのテキスト色
+// TRANSLATION MISSING
+* _color_bg_inactive_: background color for window bar which is not displayed
+  in active window
 * _color_delim_: バーの区切り文字の色
 * _color_bg_: バーの背景色
 * _separator_:
@@ -14694,6 +14700,7 @@ struct t_gui_bar *my_bar = weechat_bar_new ("mybar",
                                             "default",
                                             "cyan",
                                             "blue",
+                                            "darkgray",
                                             "off",
                                             "time,buffer_number+buffer_name");
 ----
@@ -14705,13 +14712,20 @@ struct t_gui_bar *my_bar = weechat_bar_new ("mybar",
 # プロトタイプ
 bar = weechat.bar_new(name, hidden, priority, type, condition, position,
     filling_top_bottom, filling_left_right, size, size_max,
-    color_fg, color_delim, color_bg, separator, items)
+    color_fg, color_delim, color_bg, color_bg_inactive, separator, items)
 
 # 例
 bar = weechat.bar_new("mybar", "off", "100", "window", "", "top", "horizontal", "vertical",
-    "0", "5", "default", "cyan", "blue", "off", "time,buffer_number+buffer_name")
+    "0", "5", "default", "cyan", "blue", "darkgray", "off", "time,buffer_number+buffer_name")
 ----
 
+// TRANSLATION MISSING
+[NOTE]
+With WeeChat ≥ 2.9, in Ruby, the 4 colors (color_fg, color_delim, color_bg,
+color_bg_inactive) must be given in an array of 4 strings (due to a Ruby
+limitation of 15 arguments by function), see the
+link:++weechat_scripting.en.html#_ruby++[WeeChat scripting guide] for more info.
+
 ==== bar_set
 
 バープロパティに新しい値を設定。
diff --git a/doc/ja/weechat_scripting.ja.adoc b/doc/ja/weechat_scripting.ja.adoc
index 9e54c8e17..2527d2068 100644
--- a/doc/ja/weechat_scripting.ja.adoc
+++ b/doc/ja/weechat_scripting.ja.adoc
@@ -170,6 +170,17 @@ Weechat.config_new_option(config, section, "name", "string", "description of opt
                           "value", "value", 0, ["check_cb", "", "change_cb", "", "delete_cb", ""])
 ----
 
+// TRANSLATION MISSING
+And the function `+Weechat.bar_new+` receives the colors in an array of 4 strings
+(color_fg, color_delim, color_bg, color_bg_inactive), so a call to this function
+looks like:
+
+[source,ruby]
+----
+Weechat.bar_new("name", "off", "0", "window", "", "left", "vertical", "vertical", "0", "0",
+                ["default", "default", "default", "default"], "0", "items")
+----
+
 ==== Lua
 
 // TRANSLATION MISSING
diff --git a/doc/pl/weechat_scripting.pl.adoc b/doc/pl/weechat_scripting.pl.adoc
index 6dd45a854..abc2f2eb4 100644
--- a/doc/pl/weechat_scripting.pl.adoc
+++ b/doc/pl/weechat_scripting.pl.adoc
@@ -163,6 +163,17 @@ Weechat.config_new_option(config, section, "name", "string", "opis opcji", "", 0
                           "value", "wartość", 0, ["check_cb", "", "change_cb", "", "delete_cb", ""])
 ----
 
+// TRANSLATION MISSING
+And the function `+Weechat.bar_new+` receives the colors in an array of 4 strings
+(color_fg, color_delim, color_bg, color_bg_inactive), so a call to this function
+looks like:
+
+[source,ruby]
+----
+Weechat.bar_new("name", "off", "0", "window", "", "left", "vertical", "vertical", "0", "0",
+                ["default", "default", "default", "default"], "0", "items")
+----
+
 ==== Lua
 
 ===== Funkcje