From f9a1f526c897a3f8c94c697f3624de0e1c250fcd Mon Sep 17 00:00:00 2001
From: Mitchell Hashimoto <m@mitchellh.com>
Date: Tue, 16 Dec 2025 11:38:25 -0800
Subject: [PATCH] update some copy for the background opacity toggle

---
 src/apprt/action.zig  | 4 +++-
 src/input/command.zig | 2 +-
 2 files changed, 4 insertions(+), 2 deletions(-)

diff --git a/src/apprt/action.zig b/src/apprt/action.zig
index 7b9e9d222..8e0a9d018 100644
--- a/src/apprt/action.zig
+++ b/src/apprt/action.zig
@@ -115,7 +115,9 @@ pub const Action = union(Key) {
     /// Toggle the visibility of all Ghostty terminal windows.
     toggle_visibility,
 
-    /// Toggle the window background opacity. This currently only works on macOS.
+    /// Toggle the window background opacity. This only has an effect
+    /// if the window started as transparent (non-opaque), and toggles
+    /// it between fully opaque and the configured background opacity.
     toggle_background_opacity,
 
     /// Moves a tab by a relative offset.
diff --git a/src/input/command.zig b/src/input/command.zig
index d5daafd7d..6ac4312a9 100644
--- a/src/input/command.zig
+++ b/src/input/command.zig
@@ -621,7 +621,7 @@ fn actionCommands(action: Action.Key) []const Command {
         .toggle_background_opacity => comptime &.{.{
             .action = .toggle_background_opacity,
             .title = "Toggle Background Opacity",
-            .description = "Toggle the window background between transparent and opaque.",
+            .description = "Toggle the background opacity of a window that started transparent.",
         }},
 
         .check_for_updates => comptime &.{.{