wez/wezterm
1
1
Fork 0
mirror of https://github.com/wez/wezterm.git synced 2024-12-25 06:12:16 +03:00
Code Issues Projects Releases Wiki Activity

docs: updated window_decorations

Browse Source
This commit is contained in:
Wez Furlong 2023-03-22 18:24:30 -07:00
parent 69f9e1a429
commit b5c945fe48
No known key found for this signature in database
GPG Key ID: 7A7F66A31EC9B387
1 changed files with 16 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
docs/config/lua/config/window_decorations.md
View File

@ -1,6 +1,6 @@
# `window_decorations = "TITLE | RESIZE"` # `window_decorations = "TITLE | RESIZE"`
*Since 20210314-114017-04b7cedd* {{since('20210314-114017-04b7cedd')}}
Configures whether the window has a title bar and/or resizable border. Configures whether the window has a title bar and/or resizable border.
@ -14,6 +14,16 @@ The value is a set of of flags:
* `window_decorations = "RESIZE"` - disable the title bar but enable the resizable border * `window_decorations = "RESIZE"` - disable the title bar but enable the resizable border
* `window_decorations = "TITLE | RESIZE"` - Enable titlebar and border. This is the default. * `window_decorations = "TITLE | RESIZE"` - Enable titlebar and border. This is the default.
{{since('20230320-124340-559cb7b0', outline=true)}}
The following flags are also supported on macOS:
* `MACOS_FORCE_DISABLE_SHADOW` - disable the window shadow effect
* `MACOS_FORCE_ENABLE_SHADOW` - enable the window shadow effect.
The window shadow effect is normally disabled by wezterm when the
[window_background_opacity](../../appearance.md#window-background-opacity) is set
to less than `1.0`.
On X11 and Wayland, the windowing system may override the window decorations. On X11 and Wayland, the windowing system may override the window decorations.
When the titlebar is disabled you can drag the window using the tab bar if it When the titlebar is disabled you can drag the window using the tab bar if it
@ -33,10 +43,11 @@ desktop environment to resize the window. Windows users may wish to consider
problems with resizing and minimizing the window. You usually want to keep problems with resizing and minimizing the window. You usually want to keep
`RESIZE` enabled. `RESIZE` enabled.
If you just want to remove the title bar, set `window_decorations = "RESIZE"` !!! danger
as you will run into problems if you remove `RESIZE` from the set of If you just want to remove the title bar, set `window_decorations = "RESIZE"`
decorations. as you will run into problems if you remove `RESIZE` from the set of
decorations.
!!! info !!! tip
You probably always want `RESIZE` to be listed in your `window_decorations`. You probably always want `RESIZE` to be listed in your `window_decorations`.