summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorder richter <der.richter@gmx.de>2024-03-10 13:44:40 +0100
committerder richter <der.richter@gmx.de>2024-03-10 14:53:07 +0100
commit0ec385bc763567cbab4532b3579cd24b07958802 (patch)
tree3b1f1abe8801d8c9c3a998478d41c5ccbe638eb7 /DOCS
parenta56d8ff18470e4612cbb23e35e7849b8e522ba7e (diff)
downloadmpv-0ec385bc763567cbab4532b3579cd24b07958802.tar.bz2
mpv-0ec385bc763567cbab4532b3579cd24b07958802.tar.xz
options: remove --focus-on-open and add --focus-on
replaces the old focus-on-open option with a more generic focus-on options that can be extended. adjust the only platform that uses that option. Fixes #8337
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/interface-changes.rst1
-rw-r--r--DOCS/man/options.rst9
2 files changed, 7 insertions, 3 deletions
diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst
index 14557de1b5..5852aeb709 100644
--- a/DOCS/interface-changes.rst
+++ b/DOCS/interface-changes.rst
@@ -63,6 +63,7 @@ Interface changes
- add `--border-background` option
- add `video-target-params` property
- add `hdr10plus` sub-parameter to `format` video filter
+ - remove `--focus-on-open` and add replacement `--focus-on`
--- mpv 0.37.0 ---
- `--save-position-on-quit` and its associated commands now store state files
in %LOCALAPPDATA% instead of %APPDATA% directory by default on Windows.
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index 6a09cf3884..100fc0482b 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -3227,10 +3227,13 @@ Window
:desktop: On top of the Desktop behind windows and Desktop icons.
:level: A level as integer.
-``--focus-on-open``, ``--no-focus-on-open``
+``--focus-on=<never|open|all>``,
(macOS only)
- Focus the video window on creation and makes it the front most window. This
- is on by default.
+ Focus the video window and make it the front most window on specific events (default: open).
+
+ :never: Never focus the window on open or new file load events.
+ :open: Focus the window on creation, eg when a vo is initialised.
+ :all: Focus the window on open and new file load event.
``--window-corners=<default|donotround|round|roundsmall>``
(Windows only)