From: Georg Baum <Georg.Baum@post.rwth-aachen.de>
Date: Thu, 4 Jan 2007 08:48:43 +0000 (+0000)
Subject: Fix documentation of Selection::get(): The X selection protocol is asyncronous.
X-Git-Tag: 1.6.10~11371
X-Git-Url: https://git.lyx.org/gitweb/?a=commitdiff_plain;h=84763472b864f5a36c10577d5dce1f35b77b98af;p=features.git

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 94410c498f..81380d164a 100644
--- 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;