Fix documentation of Selection::get(): The X selection protocol is asyncronous.

git-svn-id: svn://svn.lyx.org/lyx/lyx-devel/trunk@16486 a592a061-630c-0410-9148-cb99ea01b6c8

diff --git a/src/frontends/Selection.h b/src/frontends/Selection.h
index 94410c498f12c05211794ee016b685a2d43dcde3..81380d164a99dc1b6b615f746334d0889563c353 100644 (file)
--- a/src/frontends/Selection.h
+++ b/src/frontends/Selection.h
@@ -39,8 +39,14 @@ public:
        virtual docstring const get() const = 0;
        /**
         * Fill the X selection.
+        * The format is plain text.
         * Does nothing on systems that don't have a selection.
-        * This should be called whenever some text is highlighted.
+        * Since the X selection protocol is asyncronous this should never be
+        * called from the kernel.
+        * If another application requests the current selection a
+        * SelectionRequest XEvent will be triggered. The response of the
+        * frontend to this event should be to retrieve the current selection
+        * from the kernel and push it to X with this method.
         */
        virtual void put(docstring const &) = 0;