From 4ad1fa28b4ac1abcef4316c0d64fae4cac3c6b76 Mon Sep 17 00:00:00 2001
From: nanahi <130121847+na-na-hi@users.noreply.github.com>
Date: Thu, 16 May 2024 02:47:49 -0400
Subject: [PATCH] DOCS/interface-changes.rst: document loadfile breaking change

---
 DOCS/interface-changes.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst
index b55ef97739..28f6005653 100644
--- a/DOCS/interface-changes.rst
+++ b/DOCS/interface-changes.rst
@@ -64,7 +64,11 @@ Interface changes
     - change `--hidpi-window-scale` default to `no`
     - add `insert-next`, `insert-next-play`, `insert-at`, and `insert-at-play`
       actions to `loadfile` and `loadlist` commands
-    - add `index` argument to `loadfile` and `loadlist` commands
+    - add `index` argument to `loadlist` command
+    - add `index` argument to `loadfile` command. This breaks all existing
+      uses of this command which make use of the argument to include the list of
+      options to be set while the file is playing. To address this problem, the
+      third argument now needs to be set to -1 if the fourth argument needs to be used.
     - move the `options` argument of the `loadfile` command from the third
       parameter to the fourth (after `index`)
     - add `--drag-and-drop=insert-next` option