From 994f5d058b721005bba3c2b5baae7aa0486c7f44 Mon Sep 17 00:00:00 2001
From: ManoloFLTK <41016272+ManoloFLTK@users.noreply.github.com>
Date: Wed, 1 Nov 2023 10:41:51 +0100
Subject: [PATCH] Fix: Fl::clipboard_contains() cannot query selection buffer
 (#690)

---
 FL/Fl.H | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/FL/Fl.H b/FL/Fl.H
index 42eec3953..b52c33c72 100644
--- a/FL/Fl.H
+++ b/FL/Fl.H
@@ -1032,7 +1032,12 @@ public:
   */
   static void remove_clipboard_notify(Fl_Clipboard_Notify_Handler h);
   /** Returns non 0 if the clipboard contains data matching \p type.
-   \p type can be Fl::clipboard_plain_text or Fl::clipboard_image.
+   The clipboard can contain both text and image data;  in that situation this function
+   returns non 0 to both requests.
+   This function is \e not meant to check whether the clipboard is empty.
+   This function does not allow to query the selection buffer because FLTK
+   allows to copy/paste non-textual data only from/to the clipboard.
+   \param type can be Fl::clipboard_plain_text or Fl::clipboard_image.
    */
   static int clipboard_contains(const char *type);
   /**  Denotes plain textual data