1 files changed, 11 insertions, 1 deletions
diff --git a/include/term/term.h b/include/term/term.h
index 4853ebf..9c6281b 100644
--- a/include/term/term.h
+++ b/include/term/term.h
@@ -120,7 +120,17 @@ struct term_callbacks {
     /* Bytes the terminal sends back to the program (replies to queries). */
     void (*reply)(void *ud, const char *bytes, size_t len);
     void (*title)(void *ud, const char *title);
-    /* OSC 52. selection names the target, such as "c". */
+    /*
+     * OSC 52 clipboard callback.
+     * selection names the target clipboard buffer(s), commonly:
+     *   "c" - clipboard (system clipboard)
+     *   "p" - primary selection (X11 primary)
+     *   "q" - secondary selection
+     *   "s" - select selection
+     *   "0".."7" - cut buffers 0 to 7
+     * A parameter may contain multiple targets (e.g. "cp").
+     * data contains decoded bytes of length len.
+     */
     void (*clipboard)(void *ud, const char *selection, const char *data, size_t len);
     void (*notify)(void *ud, const char *title, const char *body);
     void (*bell)(void *ud);