Doc only: fix for "Fl::awake() and Fl::add_timeout()" (#524)

1 files changed, 8 insertions, 2 deletions

diff --git a/src/Fl_lock.cxx b/src/Fl_lock.cxx
index fdf045be9..d7bdf9c34 100644
--- a/src/Fl_lock.cxx
+++ b/src/Fl_lock.cxx
@@ -179,8 +179,14 @@ int Fl::awake(Fl_Awake_Handler func, void *data) {
     argument will trigger event loop handling in the main thread. Since
     it is not possible to call Fl::flush() from a subsidiary thread,
     Fl::awake() is the best (and only, really) substitute.
-
-    See also: \ref advanced_multithreading
+ 
+    It's \e not necessary to wrap calls to any form of Fl::awake() by Fl::lock() and Fl::unlock().
+    Nevertheless, the early, single call to Fl::lock() used to initialize threading support is necessary.
+ 
+    Function Fl::awake() in all its forms is typically called by worker threads, but it can be used safely
+    by the main thread too, as a means to break the event loop.
+
+    \see \ref advanced_multithreading
 */
 
 void Fl::awake(void *v) {