From 7a434575acc6cb8121ae790ab94250b331b412f4 Mon Sep 17 00:00:00 2001
From: ManoloFLTK <41016272+ManoloFLTK@users.noreply.github.com>
Date: Sat, 21 Oct 2023 09:46:20 +0200
Subject:  Fix "Keyboard sometimes stops working after Ctrl/+ or Ctrl/-" (#794)

---
 src/Fl.cxx | 4 ++++
 1 file changed, 4 insertions(+)

(limited to 'src/Fl.cxx')

diff --git a/src/Fl.cxx b/src/Fl.cxx
index e204a1cd5..94cfff6e8 100644
--- a/src/Fl.cxx
+++ b/src/Fl.cxx
@@ -943,6 +943,10 @@ Fl_Widget* fl_oldfocus; // kludge for Fl_Group...
 /**
     Sets the widget that will receive FL_KEYBOARD events.
 
+    Use this function inside the \c handle(int) member function of a widget of yours
+    to give focus to the widget, for example when it receives the FL_FOCUS or the FL_PUSH event.
+    Otherwise, use Fl_Widget::take_focus() to give focus to a widget;
+ 
     If you change Fl::focus(), the previous widget and all
     parents (that don't contain the new widget) are sent FL_UNFOCUS
     events.  Changing the focus does \e not send FL_FOCUS to
-- 
cgit v1.2.3