runtime(doc): clarify W11 warning and possible options

fixes: #18589

Signed-off-by: Christian Brabandt <cb@256bit.org>

diff --git a/runtime/doc/message.txt b/runtime/doc/message.txt
index 33b8fbdfeed0edb761e77232d665f1c4d5b45900..a8d7b577c8a0ea70e9c942dfb099ad6740ce81b3 100644 (file)
--- a/runtime/doc/message.txt
+++ b/runtime/doc/message.txt
@@ -1,4 +1,4 @@
-*message.txt*   For Vim version 9.1.  Last change: 2025 Oct 12
+*message.txt*   For Vim version 9.1.  Last change: 2025 Nov 01
 
 
                  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -644,6 +644,22 @@ Set the 'autoread' option if you want to do this automatically.
 This message is not given when 'buftype' is not empty.
 Also see the |FileChangedShell| autocommand.
 
+You will be given a dialog with the following options:
+
+"OK":          Dismiss the warning and continue editing.  No changes are
+               loaded, the buffer remains as it is.
+
+"Load File":   Reload the file from disk, replacing the current buffer
+               contents.  Any changes you made in Vim that haven't been saved
+               will be lost.
+
+"Load File and Options":
+               Reload the file from disk and, in addition, apply relevant
+               file settings, such as indentation, syntax highlighting, text
+               width, and other filetype-specific options.  This ensures the
+               buffer matches the file's intended configuration according to
+               your current settings and autocommands.
+
 There is one situation where you get this message even though there is nothing
 wrong: If you save a file in Windows on the day the daylight saving time
 starts.  It can be fixed in one of these ways: