patch 9.1.0868: the warning about missing clipboard can be improved

Problem:  the warning about missing clipboard can be improved
          (after v9.1.0852)
Solution: use different warnings depending on whether or not clipboard
          support is included in Vim, update related documentation

Improve the Warnings about missing clipboard registers

- Make it translatable
- Use a different warning, when clipboard support was not compiled in
- add a reference to :h W24
- explain in more detail the error message

closes: #16069

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

diff --git a/runtime/doc/gui.txt b/runtime/doc/gui.txt
index 4fdfc0f05a7dd1144cac5031167b1b10b4580974..76d851dc5d8a2d455d81572780a4f6b1c277accf 100644 (file)
--- a/runtime/doc/gui.txt
+++ b/runtime/doc/gui.txt
@@ -1,4 +1,4 @@
-*gui.txt*       For Vim version 9.1.  Last change: 2024 Nov 07
+*gui.txt*       For Vim version 9.1.  Last change: 2024 Nov 17
 
 
                  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -474,7 +474,7 @@ When the "unnamed" string is included in the 'clipboard' option, the unnamed
 register is the same as the "* register.  Thus you can yank to and paste the
 selection without prepending "* to commands.
 
-See also |W23|.
+See also |W23| and |W24|.
 
 ==============================================================================
 5. Menus                                               *menus*

diff --git a/runtime/doc/gui_x11.txt b/runtime/doc/gui_x11.txt
index 0658bfab983457d975877475313cf45522efe140..4a0d04c886726269bcc96eaa64bf07d9dcc4108c 100644 (file)
--- a/runtime/doc/gui_x11.txt
+++ b/runtime/doc/gui_x11.txt
@@ -1,4 +1,4 @@
-*gui_x11.txt*   For Vim version 9.1.  Last change: 2024 Nov 11
+*gui_x11.txt*   For Vim version 9.1.  Last change: 2024 Nov 17
 
 
                  VIM REFERENCE MANUAL    by Bram Moolenaar
@@ -716,6 +716,25 @@ output a warning:
 
   Warning: Clipboard register not available, using register 0 ~
 
+                                                               *W24*
+Vim comes in different flavors, from a tiny build, that just tries to be
+compatible to original Vi, to enhanced builds which include many improvements
+(like a GUI).  However, on servers and embedded systems, Vim is typically
+compiled without clipboard support, since this feature requires X11 libraries
+to be present.  Check the ":version" output for the flag |+clipboard| or
+-clipboard.  The former means clipboard support is present while the latter
+means your Vim does not contain clipboard support.
+
+In the case when you are trying to access the "* or "+ register and Vim has
+no clipboard support, you will see this warning:
+
+  Warning: Clipboard register not available. See :h W24~
+
+If you have a vim with no clipboard support but would like to use the
+clipboard, try to install a more enhanced Vim package like vim-enhanced or
+vim-gtk3 (the gui packages usually also come with a terminal Vim that has
+clipboard support included).
+
                                                        *x11-cut-buffer*
 There are, by default, 8 cut-buffers: CUT_BUFFER0 to CUT_BUFFER7.  Vim only
 uses CUT_BUFFER0, which is the one that xterm uses by default.

diff --git a/runtime/doc/tags b/runtime/doc/tags
index d61bdc7e208d4a078b36d0a973d4405becb3eaac..706970f17af320e09ed7a66852ffe36dbca639fb 100644 (file)
--- a/runtime/doc/tags
+++ b/runtime/doc/tags
@@ -5821,6 +5821,7 @@ W20       if_pyth.txt     /*W20*
 W21    if_pyth.txt     /*W21*
 W22    userfunc.txt    /*W22*
 W23    gui_x11.txt     /*W23*
+W24    gui_x11.txt     /*W24*
 WORD   motion.txt      /*WORD*
 WSL    os_win32.txt    /*WSL*
 WWW    intro.txt       /*WWW*

diff --git a/src/message.c b/src/message.c
index 5853e471feff4f40b0cc64e8e7d0fbe78a3c6a3c..95bd7263a93e7e43cba804a5c7f848bda49e0a54 100644 (file)
--- a/src/message.c
+++ b/src/message.c
@@ -56,7 +56,6 @@ static FILE *verbose_fd = NULL;
 static int  verbose_did_open = FALSE;
 
 static int  did_warn_clipboard = FALSE;
-static char *warn_clipboard = "W23: Clipboard register not available, using register 0";
 
 /*
  * When writing messages to the screen, there are many different situations.
@@ -4071,7 +4070,11 @@ msg_warn_missing_clipboard(void)
 {
     if (!global_busy && !did_warn_clipboard)
     {
-       msg(_(warn_clipboard));
+#ifdef FEAT_CLIPBOARD
+       msg(_("W23: Clipboard register not available, using register 0"));
+#else
+       msg(_("W24: Clipboard register not available. See :h W24"));
+#endif
        did_warn_clipboard = TRUE;
     }
 }

diff --git a/src/testdir/test_registers.vim b/src/testdir/test_registers.vim
index f2d38d8391cd112f8ab367a53d65172768644ab6..732cc60bc1f10b8a9a7d696ad34805dce4c936bb 100644 (file)
--- a/src/testdir/test_registers.vim
+++ b/src/testdir/test_registers.vim
@@ -1052,7 +1052,7 @@ func Test_clipboard_regs_not_working()
     new
     call append(0, "text for clipboard test")
     let mess = execute(':norm "*yiw')
-    call assert_match('W23', mess)
+    call assert_match('W24', mess)
     bw!
   endif
 endfunc

diff --git a/src/version.c b/src/version.c
index d4a4e972482ac65f415693eda719bbbff081e0c0..b4eb42905a55d8169ecbb9754730e985bc1dc44c 100644 (file)
--- a/src/version.c
+++ b/src/version.c
@@ -704,6 +704,8 @@ static char *(features[]) =
 
 static int included_patches[] =
 {   /* Add new patch number below this line */
+/**/
+    868,
 /**/
     867,
 /**/