mirror of
https://github.com/ghostty-org/ghostty.git
synced 2025-08-02 14:57:31 +03:00
config: clarify config-file behavior
No one has actually ever complained about this but I wanted to explicitly call it out.
This commit is contained in:
@ -1199,6 +1199,21 @@ keybind: Keybinds = .{},
|
|||||||
///
|
///
|
||||||
/// Cycles are not allowed. If a cycle is detected, an error will be logged and
|
/// Cycles are not allowed. If a cycle is detected, an error will be logged and
|
||||||
/// the configuration file will be ignored.
|
/// the configuration file will be ignored.
|
||||||
|
///
|
||||||
|
/// Configuration files are loaded after the configuration they're defined
|
||||||
|
/// within in the order they're defined. **THIS IS A VERY SUBTLE BUT IMPORTANT
|
||||||
|
/// POINT.** To put it another way: configuration files do not take effect
|
||||||
|
/// until after the entire configuration is loaded. For example, in the
|
||||||
|
/// configuration below:
|
||||||
|
///
|
||||||
|
/// ```
|
||||||
|
/// config-file = "foo"
|
||||||
|
/// a = 1
|
||||||
|
/// ```
|
||||||
|
///
|
||||||
|
/// If "foo" contains `a = 2`, the final value of `a` will be 2, because
|
||||||
|
/// `foo` is loaded after the configuration file that configures the
|
||||||
|
/// nested `config-file` value.
|
||||||
@"config-file": RepeatablePath = .{},
|
@"config-file": RepeatablePath = .{},
|
||||||
|
|
||||||
/// When this is true, the default configuration file paths will be loaded.
|
/// When this is true, the default configuration file paths will be loaded.
|
||||||
|
Reference in New Issue
Block a user