core: add a parent name in options (closes #629)

Inherited values are now displayed in /set output when the value is
null, if a parent option name is defined in option.

New option: weechat.color.chat_value_null

19 files changed, 63 insertions, 4 deletions

diff --git a/doc/de/autogen/plugin_api/hdata.asciidoc b/doc/de/autogen/plugin_api/hdata.asciidoc
index dd9171e46..6ea804573 100644
--- a/doc/de/autogen/plugin_api/hdata.asciidoc
+++ b/doc/de/autogen/plugin_api/hdata.asciidoc
@@ -658,6 +658,7 @@
 *** 'config_file' (pointer, hdata: "config_file")
 *** 'section' (pointer, hdata: "config_section")
 *** 'name' (string)
+*** 'parent_name' (string)
 *** 'type' (integer)
 *** 'description' (string)
 *** 'string_values' (string, array_size: "*")
diff --git a/doc/de/autogen/user/weechat_options.asciidoc b/doc/de/autogen/user/weechat_options.asciidoc
index 9a03776aa..42e4b19f4 100644
--- a/doc/de/autogen/user/weechat_options.asciidoc
+++ b/doc/de/autogen/user/weechat_options.asciidoc
@@ -197,6 +197,11 @@
 ** Typ: Farbe
 ** Werte: ein Farbname für WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), eine Terminal-Farbnummer oder ein Alias; Attribute können vor eine Farbe gesetzt werden (gilt ausschließlich für die Textfarbe und nicht für den Hintergrund): "*" für fett, "!" für invertiert, "/" für kursiv, "_" für unterstrichen (Standardwert: `cyan`)
 
+* [[option_weechat.color.chat_value_null]] *weechat.color.chat_value_null*
+** Beschreibung: `text color for null values (undefined)`
+** Typ: Farbe
+** Werte: ein Farbname für WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), eine Terminal-Farbnummer oder ein Alias; Attribute können vor eine Farbe gesetzt werden (gilt ausschließlich für die Textfarbe und nicht für den Hintergrund): "*" für fett, "!" für invertiert, "/" für kursiv, "_" für unterstrichen (Standardwert: `blue`)
+
 * [[option_weechat.color.emphasized]] *weechat.color.emphasized*
 ** Beschreibung: `Textfarbe um Text hervorzuheben (zum Beispiel bei der Textsuche); wird ausschließlich dann genutzt, falls die Einstellung weechat.look.emphasized_attributes keinen Eintrag besitzt (Standardwert)`
 ** Typ: Farbe
diff --git a/doc/en/autogen/plugin_api/hdata.asciidoc b/doc/en/autogen/plugin_api/hdata.asciidoc
index 6b8f25048..904f694ee 100644
--- a/doc/en/autogen/plugin_api/hdata.asciidoc
+++ b/doc/en/autogen/plugin_api/hdata.asciidoc
@@ -658,6 +658,7 @@
 *** 'config_file' (pointer, hdata: "config_file")
 *** 'section' (pointer, hdata: "config_section")
 *** 'name' (string)
+*** 'parent_name' (string)
 *** 'type' (integer)
 *** 'description' (string)
 *** 'string_values' (string, array_size: "*")
diff --git a/doc/en/autogen/user/weechat_options.asciidoc b/doc/en/autogen/user/weechat_options.asciidoc
index 2791b8229..e478791cc 100644
--- a/doc/en/autogen/user/weechat_options.asciidoc
+++ b/doc/en/autogen/user/weechat_options.asciidoc
@@ -197,6 +197,11 @@
 ** type: color
 ** values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "*" for bold, "!" for reverse, "/" for italic, "_" for underline (default value: `cyan`)
 
+* [[option_weechat.color.chat_value_null]] *weechat.color.chat_value_null*
+** description: `text color for null values (undefined)`
+** type: color
+** values: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "*" for bold, "!" for reverse, "/" for italic, "_" for underline (default value: `blue`)
+
 * [[option_weechat.color.emphasized]] *weechat.color.emphasized*
 ** description: `text color for emphasized text (for example when searching text); this option is used only if option weechat.look.emphasized_attributes is an empty string (default value)`
 ** type: color
diff --git a/doc/en/weechat_dev.en.asciidoc b/doc/en/weechat_dev.en.asciidoc
index d13d8cc1e..1484afeaa 100644
--- a/doc/en/weechat_dev.en.asciidoc
+++ b/doc/en/weechat_dev.en.asciidoc
@@ -873,6 +873,7 @@ Color codes using options (see 't_gui_color_enum', in file
 | 41   | weechat.color.chat_nick_suffix _(WeeChat ≥ 0.4.1)_
 | 42   | weechat.color.emphasized _(WeeChat ≥ 0.4.2)_
 | 43   | weechat.color.chat_day_change _(WeeChat ≥ 0.4.2)_
+| 44   | weechat.color.chat_value_null _(WeeChat ≥ 1.4)_
 |===
 
 WeeChat colors are:
diff --git a/doc/en/weechat_plugin_api.en.asciidoc b/doc/en/weechat_plugin_api.en.asciidoc
index 4d945e3e0..7366e4cab 100644
--- a/doc/en/weechat_plugin_api.en.asciidoc
+++ b/doc/en/weechat_plugin_api.en.asciidoc
@@ -4632,7 +4632,10 @@ Arguments:
 
 * 'config_file': configuration file pointer
 * 'section': section pointer
-* 'name': name of option
+* 'name': name of option; with WeeChat ≥ 1.4, the name can include a parent
+  option name (the value of parent option will be displayed in `/set` command
+  output if this option is "null"), the syntax is then:
+  "name << file.section.option"
 * 'type': type of option:
 ** 'boolean': boolean value (on/off)
 ** 'integer': integer value (with optional strings for values)
@@ -5300,6 +5303,7 @@ Arguments:
 ** 'config_file': configuration file pointer ('struct t_config_file *')
 ** 'section': section pointer ('struct t_config_section *')
 ** 'name': option name ('char *')
+** 'parent_name': name of parent option ('char *') _(WeeChat ≥ 1.4)_
 ** 'type': option type ('int *')
 ** 'description': option description ('char *')
 ** 'string_values': string values ('char *')
diff --git a/doc/fr/autogen/plugin_api/hdata.asciidoc b/doc/fr/autogen/plugin_api/hdata.asciidoc
index 77204cfaf..fcabef755 100644
--- a/doc/fr/autogen/plugin_api/hdata.asciidoc
+++ b/doc/fr/autogen/plugin_api/hdata.asciidoc
@@ -658,6 +658,7 @@
 *** 'config_file' (pointer, hdata: "config_file")
 *** 'section' (pointer, hdata: "config_section")
 *** 'name' (string)
+*** 'parent_name' (string)
 *** 'type' (integer)
 *** 'description' (string)
 *** 'string_values' (string, array_size: "*")
diff --git a/doc/fr/autogen/user/weechat_options.asciidoc b/doc/fr/autogen/user/weechat_options.asciidoc
index 728c7085f..869ebe91d 100644
--- a/doc/fr/autogen/user/weechat_options.asciidoc
+++ b/doc/fr/autogen/user/weechat_options.asciidoc
@@ -197,6 +197,11 @@
 ** type: couleur
 ** valeurs: un nom de couleur WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), un numéro de couleur du terminal ou un alias ; des attributs sont autorisés avant la couleur (seulement pour la couleur du texte, pas le fond) : "*" pour le gras, "!" pour la vidéo inverse, "/" pour l'italique, "_" pour le souligné (valeur par défaut: `cyan`)
 
+* [[option_weechat.color.chat_value_null]] *weechat.color.chat_value_null*
+** description: `couleur du texte pour les valeurs "null" (non définies)`
+** type: couleur
+** valeurs: un nom de couleur WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), un numéro de couleur du terminal ou un alias ; des attributs sont autorisés avant la couleur (seulement pour la couleur du texte, pas le fond) : "*" pour le gras, "!" pour la vidéo inverse, "/" pour l'italique, "_" pour le souligné (valeur par défaut: `blue`)
+
 * [[option_weechat.color.emphasized]] *weechat.color.emphasized*
 ** description: `couleur du texte pour le texte mis en valeur (par exemple lors de la recherche de texte) ; cette option est utilisée seulement si l'option weechat.look.emphasized_attributes est une chaîne vide (valeur par défaut)`
 ** type: couleur
diff --git a/doc/fr/weechat_dev.fr.asciidoc b/doc/fr/weechat_dev.fr.asciidoc
index 0ec591865..991e25380 100644
--- a/doc/fr/weechat_dev.fr.asciidoc
+++ b/doc/fr/weechat_dev.fr.asciidoc
@@ -888,6 +888,7 @@ fichier 'src/gui/gui-color.h') :
 | 41   | weechat.color.chat_nick_suffix _(WeeChat ≥ 0.4.1)_
 | 42   | weechat.color.emphasized _(WeeChat ≥ 0.4.2)_
 | 43   | weechat.color.chat_day_change _(WeeChat ≥ 0.4.2)_
+| 44   | weechat.color.chat_value_null _(WeeChat ≥ 1.4)_
 |===
 
 Les couleurs WeeChat sont :
diff --git a/doc/fr/weechat_plugin_api.fr.asciidoc b/doc/fr/weechat_plugin_api.fr.asciidoc
index 8ad462c5d..eb2f3a1e2 100644
--- a/doc/fr/weechat_plugin_api.fr.asciidoc
+++ b/doc/fr/weechat_plugin_api.fr.asciidoc
@@ -4708,7 +4708,10 @@ Paramètres :
 
 * 'config_file' : pointeur vers le fichier de configuration
 * 'section' : pointeur vers la section
-* 'name' : nom de l'option
+* 'name' : nom de l'option ; avec WeeChat ≥ 1.4, le nom peut inclure le nom
+  d'une option parente (la valeur de l'option parente sera affichée dans la
+  sortie de `/set` si cette option est "null"), la syntaxe est alors :
+  "name << file.section.option"
 * 'type' : type de l'option :
 ** 'boolean' : valeur booléenne (on/off)
 ** 'integer' : valeur entière (avec en option une chaîne pour chaque valeur)
@@ -5386,6 +5389,7 @@ Paramètres :
    ('struct t_config_file *')
 ** 'section' : pointeur vers la section ('struct t_config_section *')
 ** 'name' : nom de l'option ('char *')
+** 'parent_name' : nom de l'option parente ('char *') _(WeeChat ≥ 1.4)_
 ** 'type' : type de l'option ('int *')
 ** 'description' : description de l'option ('char *')
 ** 'string_values' : valeurs sous forme de chaîne ('char *')
diff --git a/doc/it/autogen/plugin_api/hdata.asciidoc b/doc/it/autogen/plugin_api/hdata.asciidoc
index e3b8459aa..c49a21e7d 100644
--- a/doc/it/autogen/plugin_api/hdata.asciidoc
+++ b/doc/it/autogen/plugin_api/hdata.asciidoc
@@ -658,6 +658,7 @@
 *** 'config_file' (pointer, hdata: "config_file")
 *** 'section' (pointer, hdata: "config_section")
 *** 'name' (string)
+*** 'parent_name' (string)
 *** 'type' (integer)
 *** 'description' (string)
 *** 'string_values' (string, array_size: "*")
diff --git a/doc/it/autogen/user/weechat_options.asciidoc b/doc/it/autogen/user/weechat_options.asciidoc
index b844fdcf4..9c7238464 100644
--- a/doc/it/autogen/user/weechat_options.asciidoc
+++ b/doc/it/autogen/user/weechat_options.asciidoc
@@ -197,6 +197,11 @@
 ** tipo: colore
 ** valori: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "*" for bold, "!" for reverse, "/" for italic, "_" for underline (valore predefinito: `cyan`)
 
+* [[option_weechat.color.chat_value_null]] *weechat.color.chat_value_null*
+** descrizione: `text color for null values (undefined)`
+** tipo: colore
+** valori: a WeeChat color name (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), a terminal color number or an alias; attributes are allowed before color (for text color only, not background): "*" for bold, "!" for reverse, "/" for italic, "_" for underline (valore predefinito: `blue`)
+
 * [[option_weechat.color.emphasized]] *weechat.color.emphasized*
 ** descrizione: `text color for emphasized text (for example when searching text); this option is used only if option weechat.look.emphasized_attributes is an empty string (default value)`
 ** tipo: colore
diff --git a/doc/it/weechat_plugin_api.it.asciidoc b/doc/it/weechat_plugin_api.it.asciidoc
index b44bd9c48..6806063dc 100644
--- a/doc/it/weechat_plugin_api.it.asciidoc
+++ b/doc/it/weechat_plugin_api.it.asciidoc
@@ -4758,7 +4758,11 @@ Argomenti:
 
 * 'config_file': puntatore al file di configurazione
 * 'section': puntatore alla sezione
-* 'name': nome dell'opzione
+// TRANSLATION MISSING
+* 'name': nome dell'opzione; with WeeChat ≥ 1.4, the name can include a parent
+  option name (the value of parent option will be displayed in `/set` command
+  output if this option is "null"), the syntax is then:
+  "name << file.section.option"
 * 'type': tipo dell'opzione:
 ** 'boolean': valore booleano (on/off)
 ** 'integer': valore intero (con stringhe opzionali per i valori)
@@ -5435,6 +5439,8 @@ Argomenti:
 ** 'config_file': puntatore al file di configurazione ('struct t_config_file *')
 ** 'section': puntatore alla sezione ('struct t_config_section *')
 ** 'name': nome dell'opzione ('char *')
+// TRANSLATION MISSING
+** 'parent_name': name of parent option ('char *') _(WeeChat ≥ 1.4)_
 ** 'type': tipo dell'opzione ('int *')
 ** 'description': descrizione dell'opzione ('char *')
 ** 'string_values': valori stringa ('char *')
diff --git a/doc/ja/autogen/plugin_api/hdata.asciidoc b/doc/ja/autogen/plugin_api/hdata.asciidoc
index b4f27fa69..9873e30e9 100644
--- a/doc/ja/autogen/plugin_api/hdata.asciidoc
+++ b/doc/ja/autogen/plugin_api/hdata.asciidoc
@@ -658,6 +658,7 @@
 *** 'config_file' (pointer, hdata: "config_file")
 *** 'section' (pointer, hdata: "config_section")
 *** 'name' (string)
+*** 'parent_name' (string)
 *** 'type' (integer)
 *** 'description' (string)
 *** 'string_values' (string, array_size: "*")
diff --git a/doc/ja/autogen/user/weechat_options.asciidoc b/doc/ja/autogen/user/weechat_options.asciidoc
index 1fc5ab655..fb013faa8 100644
--- a/doc/ja/autogen/user/weechat_options.asciidoc
+++ b/doc/ja/autogen/user/weechat_options.asciidoc
@@ -197,6 +197,11 @@
 ** タイプ: 色
 ** 値: WeeChat の色名 (default、black、(dark)gray、white、(light)red、(light)green、brown、yellow、(light)blue、(light)magenta、(light)cyan) 、ターミナル色番号またはその別名; 色の前に属性を置くことができます (テキスト前景色のみ、背景色は出来ません): 太字は "*"、反転は "!"、イタリックは "/"、下線は "_" (デフォルト値: `cyan`)
 
+* [[option_weechat.color.chat_value_null]] *weechat.color.chat_value_null*
+** 説明: `text color for null values (undefined)`
+** タイプ: 色
+** 値: WeeChat の色名 (default、black、(dark)gray、white、(light)red、(light)green、brown、yellow、(light)blue、(light)magenta、(light)cyan) 、ターミナル色番号またはその別名; 色の前に属性を置くことができます (テキスト前景色のみ、背景色は出来ません): 太字は "*"、反転は "!"、イタリックは "/"、下線は "_" (デフォルト値: `blue`)
+
 * [[option_weechat.color.emphasized]] *weechat.color.emphasized*
 ** 説明: `強調テキストの色 (テキスト検索する際など); このオプションは weechat.look.emphasized_attributes オプションが空文字列 (デフォルト値) の場合のみ使われます`
 ** タイプ: 色
diff --git a/doc/ja/weechat_dev.ja.asciidoc b/doc/ja/weechat_dev.ja.asciidoc
index eb0b506ce..a2a3eb957 100644
--- a/doc/ja/weechat_dev.ja.asciidoc
+++ b/doc/ja/weechat_dev.ja.asciidoc
@@ -873,6 +873,7 @@ WeeChat は文字列中に独自の色コードを使うことで、属性
 | 41   | weechat.color.chat_nick_suffix _(WeeChat ≥ 0.4.1)_
 | 42   | weechat.color.emphasized _(WeeChat ≥ 0.4.2)_
 | 43   | weechat.color.chat_day_change _(WeeChat ≥ 0.4.2)_
+| 44   | weechat.color.chat_value_null _(WeeChat ≥ 1.4)_
 |===
 
 WeeChat 色は:
diff --git a/doc/ja/weechat_plugin_api.ja.asciidoc b/doc/ja/weechat_plugin_api.ja.asciidoc
index f65211015..ab030f169 100644
--- a/doc/ja/weechat_plugin_api.ja.asciidoc
+++ b/doc/ja/weechat_plugin_api.ja.asciidoc
@@ -4633,7 +4633,11 @@ struct t_config_option *weechat_config_new_option (
 
 * 'config_file': 設定ファイルへのポインタ
 * 'section': セクションへのポインタ
-* 'name': オプションの名前
+// TRANSLATION MISSING
+* 'name': オプションの名前; with WeeChat ≥ 1.4, the name can include a parent
+  option name (the value of parent option will be displayed in `/set` command
+  output if this option is "null"), the syntax is then:
+  "name << file.section.option"
 * 'type': オプションの型:
 ** 'boolean': ブール値 (on/off)
 ** 'integer': 整数値 (任意で文字列を受けるようにすることも可)
@@ -5301,6 +5305,8 @@ void *weechat_config_option_get_pointer (struct t_config_option *option,
 ** 'config_file': 設定ファイルへのポインタ ('struct t_config_file *')
 ** 'section': セクションへのポインタ ('struct t_config_section *')
 ** 'name': オプション名 ('char *')
+// TRANSLATION MISSING
+** 'parent_name': name of parent option ('char *') _(WeeChat ≥ 1.4)_
 ** 'type': オプションの型 ('int *')
 ** 'description': オプションの説明 ('char *')
 ** 'string_values': 文字列値 ('char *')
diff --git a/doc/pl/autogen/plugin_api/hdata.asciidoc b/doc/pl/autogen/plugin_api/hdata.asciidoc
index b33a4f083..c90a4311c 100644
--- a/doc/pl/autogen/plugin_api/hdata.asciidoc
+++ b/doc/pl/autogen/plugin_api/hdata.asciidoc
@@ -658,6 +658,7 @@
 *** 'config_file' (pointer, hdata: "config_file")
 *** 'section' (pointer, hdata: "config_section")
 *** 'name' (string)
+*** 'parent_name' (string)
 *** 'type' (integer)
 *** 'description' (string)
 *** 'string_values' (string, array_size: "*")
diff --git a/doc/pl/autogen/user/weechat_options.asciidoc b/doc/pl/autogen/user/weechat_options.asciidoc
index 62e26b089..cd76e1c96 100644
--- a/doc/pl/autogen/user/weechat_options.asciidoc
+++ b/doc/pl/autogen/user/weechat_options.asciidoc
@@ -197,6 +197,11 @@
 ** typ: kolor
 ** wartości: nazwa koloru WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), numer koloru terminala albo alias; atrybuty dozwolone przed kolorem (tylko dla kolorów testu, nie tła): "*" pogrubienie, "!" odwrócenie, "/" pochylenie, "_" podkreślenie (domyślna wartość: `cyan`)
 
+* [[option_weechat.color.chat_value_null]] *weechat.color.chat_value_null*
+** opis: `text color for null values (undefined)`
+** typ: kolor
+** wartości: nazwa koloru WeeChat (default, black, (dark)gray, white, (light)red, (light)green, brown, yellow, (light)blue, (light)magenta, (light)cyan), numer koloru terminala albo alias; atrybuty dozwolone przed kolorem (tylko dla kolorów testu, nie tła): "*" pogrubienie, "!" odwrócenie, "/" pochylenie, "_" podkreślenie (domyślna wartość: `blue`)
+
 * [[option_weechat.color.emphasized]] *weechat.color.emphasized*
 ** opis: `kolor dla wyróżnionego tekstu (na przykład podczas wyszukiwania); opcja używana tylko jeśli opcja weechat.look.emphasized_attributes jest pustym ciągiem (wartość domyślna)`
 ** typ: kolor