From 4883fd938e90c4f88cc66cb0b24da8eb2d9304fa Mon Sep 17 00:00:00 2001 From: Mitchell Hashimoto Date: Tue, 16 Dec 2025 11:27:51 -0800 Subject: [PATCH] config: better docs for split-preserve-zoom --- src/config/Config.zig | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) diff --git a/src/config/Config.zig b/src/config/Config.zig index 7ced916fe..9b4c1ed94 100644 --- a/src/config/Config.zig +++ b/src/config/Config.zig @@ -985,12 +985,20 @@ palette: Palette = .{}, /// Available since: 1.1.0 @"split-divider-color": ?Color = null, -/// Control when Ghostty preserves the zoomed state of a split. This is a packed -/// struct so more options can be added in the future. The `navigation` option -/// keeps the current split zoomed when split navigation (`goto_split`) changes -/// the focused split. +/// Control when Ghostty preserves a zoomed split. Under normal circumstances, +/// any operation that changes focus or layout of the split tree in a window +/// will unzoom any zoomed split. This configuration allows you to control +/// this behavior. +/// +/// This can be set to `navigation` to preserve the zoomed split state +/// when navigating to another split (e.g. via `goto_split`). This will +/// change the zoomed split to the newly focused split instead of unzooming. +/// +/// Any options can also be prefixed with `no-` to disable that option. /// /// Example: `split-preserve-zoom = navigation` +/// +/// Available since: 1.3.0 @"split-preserve-zoom": SplitPreserveZoom = .{}, /// The foreground and background color for search matches. This only applies