From 4c93447dbbfc639eb421bf9300a3fa89d11ab86c Mon Sep 17 00:00:00 2001
From: nanahi <130121847+na-na-hi@users.noreply.github.com>
Date: Tue, 22 Oct 2024 17:20:02 -0400
Subject: [PATCH] DOCS: mention restore-osc-bindings.conf

---
 DOCS/compatibility.rst | 2 +-
 DOCS/man/osc.rst       | 5 +++++
 README.md              | 4 ++++
 3 files changed, 10 insertions(+), 1 deletion(-)

diff --git a/DOCS/compatibility.rst b/DOCS/compatibility.rst
index aeef8fc7ca..9befbbb2a6 100644
--- a/DOCS/compatibility.rst
+++ b/DOCS/compatibility.rst
@@ -126,7 +126,7 @@ CLI
 Things such as default key bindings do not necessarily require compatibility.
 However, the release notes should be extremely clear on changes to "important"
 key bindings. Bindings which restore the old behavior should be added to
-restore-old-bindings.conf.
+restore-old-bindings.conf and restore-osc-bindings.conf.
 
 Some option parsing is CLI-only and not available from libmpv or scripting. No
 compatibility guarantees come with them. However, the rules which mpv uses to
diff --git a/DOCS/man/osc.rst b/DOCS/man/osc.rst
index 0c95f14f12..cd3989dcec 100644
--- a/DOCS/man/osc.rst
+++ b/DOCS/man/osc.rst
@@ -124,6 +124,11 @@ fs
     right-click     toggle whether the window is maximized
     =============   ================================================
 
+Since mpv 0.40.0, it is possible to configure the commands to run with mouse
+actions on some interface elements, and the default behaviors of several
+elements were changed. If you miss some older behaviors, look at
+``etc/restore-osc-bindings.conf`` in the mpv git repository.
+
 Key Bindings
 ~~~~~~~~~~~~
 
diff --git a/README.md b/README.md
index 7f5a374415..14631dae30 100644
--- a/README.md
+++ b/README.md
@@ -76,6 +76,9 @@ on every release.
 Changes to the default key bindings are indicated in
 [restore-old-bindings.conf][restore-old-bindings].
 
+Changes to the default OSC bindings are indicated in
+[restore-osc-bindings.conf][restore-osc-bindings].
+
 ## Compilation
 
 
@@ -214,4 +217,5 @@ Most activity happens on the IRC channel and the GitHub issue tracker.
 [interface-changes]: https://github.com/mpv-player/mpv/blob/master/DOCS/interface-changes.rst
 [api-changes]: https://github.com/mpv-player/mpv/blob/master/DOCS/client-api-changes.rst
 [restore-old-bindings]: https://github.com/mpv-player/mpv/blob/master/etc/restore-old-bindings.conf
+[restore-osc-bindings]: https://github.com/mpv-player/mpv/blob/master/etc/restore-osc-bindings.conf
 [contribute.md]: https://github.com/mpv-player/mpv/blob/master/DOCS/contribute.md