From f4d9d9823851e7fd1cbea048b31a108237a4bc41 Mon Sep 17 00:00:00 2001 From: frapank Date: Thu, 28 May 2026 15:43:31 +0200 Subject: [PATCH] docs: mark opacity as runtime-only command The opacity command requires a container in handler_context and is registered in command_handlers[] (runtime-only). Using it directly in the config file results in "Unknown/invalid command 'opacity'". It works only via swaymsg, bindsym, or inside for_window blocks. --- sway/sway.5.scd | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/sway/sway.5.scd b/sway/sway.5.scd index 952d243d2..c53ca8115 100644 --- a/sway/sway.5.scd +++ b/sway/sway.5.scd @@ -294,6 +294,10 @@ set|plus|minus|toggle A no operation command that can be used to override default behaviour. The optional comment argument is ignored, but logged for debugging purposes. +*opacity* [set|plus|minus] + Adjusts the opacity of the window between 0 (completely transparent) and + 1 (completely opaque). If the operation is omitted, _set_ will be used. + *reload* Reloads the sway config file and applies any changes. The config file is located at path specified by the command line arguments when started, @@ -873,10 +877,6 @@ The default colors are: Any mark that starts with an underscore will not be drawn even if *show_marks* is yes. The default is _yes_. -*opacity* [set|plus|minus] - Adjusts the opacity of the window between 0 (completely transparent) and - 1 (completely opaque). If the operation is omitted, _set_ will be used. - *tiling_drag* enable|disable|toggle Sets whether or not tiling containers can be dragged with the mouse. If _enabled_ (default), the _floating_mod_ can be used to drag tiling, as well