[gtk: 1/2] docs: Expand gdk_clipboard_set() docs

[Benjamin Otte <otte src gnome org>]

commit d2ea7af3356e472e7f64d2b2bce410018a462631
Author: Benjamin Otte <otte benjamin googlemail com>
Date:   Sun Aug 22 18:49:12 2021 +0000

    docs: Expand gdk_clipboard_set() docs

 gdk/gdkclipboard.c | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)
---
diff --git a/gdk/gdkclipboard.c b/gdk/gdkclipboard.c
index bbd1a1fde5..b2fd191538 100644
--- a/gdk/gdkclipboard.c
+++ b/gdk/gdkclipboard.c
@@ -1253,9 +1253,15 @@ gdk_clipboard_set_content (GdkClipboard       *clipboard,
  * @...: value contents conforming to @type
  *
  * Sets the clipboard to contain the value collected from the given varargs.
+ * 
+ * Values should be passed the same way they are passed to other value
+ * collecting APIs, such as [`method GObject Object set`] or
+ * [`id@g_signal_emit`].
  *
  * ```c
- * gdk_clipboard_set (clipboard, GTK_TYPE_TEXT_BUFFER, buffer);
+ * gdk_clipboard_set (clipboard, GTK_TYPE_STRING, "Hello World");
+ * 
+ * gdk_clipboard_set (clipboard, GDK_TYPE_TEXTURE, some_texture);
  * ```
  */
 void