From 82ff3abd508ed74d260633bb3dbf247e9d2aac5d Mon Sep 17 00:00:00 2001 From: Manolo Gouy Date: Sat, 11 Dec 2010 22:34:05 +0000 Subject: Moved doxygen info about Fl::paste(Fl_Widget&, int) to where it belongs. git-svn-id: file:///fltk/svn/fltk/branches/branch-1.3@8013 ea41ed52-d2ee-0310-a9c1-e6b18d33e121 --- FL/Fl.H | 18 +++++++++++++----- 1 file changed, 13 insertions(+), 5 deletions(-) (limited to 'FL') diff --git a/FL/Fl.H b/FL/Fl.H index e62bdbc02..c28c24415 100644 --- a/FL/Fl.H +++ b/FL/Fl.H @@ -689,11 +689,19 @@ public: */ static void copy(const char* stuff, int len, int clipboard = 0); // platform dependent /** - Pastes the data from the selection clipboard (0) or the copy clipboard (1) - into receiver. - The selection clipboard is used for middle-mouse pastes and for - drag-and-drop selections. The copy clipboard is used for traditional - copy/cut/paste operations. + Pastes the data from the selection clipboard (0) or the copy clipboard (1) + into receiver. + Set things up so the receiver widget will be called with an FL_PASTE event some + time in the future for the specified clipboard. The receiver + should be prepared to be called \e directly by this, or for + it to happen \e later, or possibly not at all. This + allows the window system to take as long as necessary to retrieve + the paste buffer (or even to screw up completely) without complex + and error-prone synchronization code in FLTK. + + The selection clipboard is used for middle-mouse pastes and for + drag-and-drop selections. The copy clipboard is used for traditional + copy/cut/paste operations. */ static void paste(Fl_Widget &receiver, int clipboard /*=0*/); // platform dependent /** -- cgit v1.2.3