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

1 files changed, 13 insertions, 5 deletions

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 <i>not at all</i>.  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
   /**