runtime(doc): clarify 'icon' and 'title' interaction for screen 5

related: #20553
related: #20604
closes:  #20703

Signed-off-by: Christoffer Aasted <dezzadk@gmail.com>
Signed-off-by: Christian Brabandt <cb@256bit.org>

diff --git a/runtime/doc/options.txt b/runtime/doc/options.txt
index 7b3713b0d465100205b1e2c21b9f0af7578e2e83..549b22a8533d5973e38261c5f9c3c89f196e88b8 100644 (file)
--- a/runtime/doc/options.txt
+++ b/runtime/doc/options.txt
@@ -1,4 +1,4 @@
-*options.txt*  For Vim version 9.2.  Last change: 2026 Jul 03
+*options.txt*  For Vim version 9.2.  Last change: 2026 Jul 22
 
 
                  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -4948,9 +4948,8 @@ A jump table for the options with a short description can be found at |Q_op|.
        restored if possible |X11|.  See |X11-icon| for changing the icon on
        X11.
        For MS-Windows the icon can be changed, see |windows-icon|.
-       NOTE: Some terminals treat the icon text as an alias for the window
-       title.  On those, setting the icon text may also change the terminal
-       window title; see 'title'.
+       NOTE: GNU screen is not consistent in handling icon-title and title escape
+       sequences between versions.   See 'title'.
 
                                                *'iconstring'*
 'iconstring'           string  (default "")
@@ -9638,9 +9637,9 @@ A jump table for the options with a short description can be found at |Q_op|.
        then the WINDOWID environment variable should be inherited and the
        title of the window should change back to what it should be after
        exiting Vim.
-       NOTE: Some terminals treat the icon text as an alias for the window
-       title (see 'icon').  On those, the interaction between 'title' and
-       'icon' depend on the specific behavior of the terminal.
+       NOTE: GNU screen is not consistent in handling icon-title and title escape
+       sequences between versions. In particular, screen 5 may swap title and
+       icon-title.
 
                                                                *'titlelen'*
 'titlelen'             number  (default 85)