summaryrefslogtreecommitdiffstats
path: root/DOCS/man
diff options
context:
space:
mode:
authorPhilip Langdale <philipl@overt.org>2019-12-03 21:48:06 +0800
committerPhilip Langdale <philipl@overt.org>2019-12-04 09:32:25 +0800
commit353e4efdefca0fe118f5717783bf7e1df3592620 (patch)
treeddebf2314988c8be11e5de03f5aa31bc54f2bc18 /DOCS/man
parentf8689eff6d8c982ed970f02929a50be1406e1e25 (diff)
downloadmpv-353e4efdefca0fe118f5717783bf7e1df3592620.tar.bz2
mpv-353e4efdefca0fe118f5717783bf7e1df3592620.tar.xz
osc: rework window control configuration to add auto mode
To aid in discoverability, and to address the most common case directly, I'm adding an 'auto' mode for the window controls. In this case, we will show the controls if there is no window border and hide them if there are borders. This also respects the option being toggled at runtime. To ensure that it works in the wayland case, I've also made sure that the wayland code explicitly forces the option to false if decoration support is missing. Based on feedback, I've split the config in two, with one option for whether controls are active, and one for alignment. These are new enough that we can get away with ignoring compatibility.
Diffstat (limited to 'DOCS/man')
-rw-r--r--DOCS/man/osc.rst8
1 files changed, 7 insertions, 1 deletions
diff --git a/DOCS/man/osc.rst b/DOCS/man/osc.rst
index f9d3282098..b243acf749 100644
--- a/DOCS/man/osc.rst
+++ b/DOCS/man/osc.rst
@@ -344,7 +344,7 @@ Configurable Options
fixed later.
``windowcontrols``
- Default: no (Do not show window controls)
+ Default: auto (Show window controls if there is no window border)
Whether to show window management controls over the video, and if so,
which side of the window to place them. This may be desirable when the
@@ -356,6 +356,12 @@ Configurable Options
and ``quit``. Not all platforms implement ``minimize`` and ``maximize``,
but ``quit`` will always work.
+``windowcontrols_alignment``
+ Default: right
+
+ If window controls are shown, indicates which side should they be aligned
+ to.
+
Supports ``left`` and ``right`` which will place the controls on those
respective sides.