Documented click event on activate behavior in the GTK+ backend.

2 files changed, 5 insertions, 1 deletions

diff --git a/area_unix.go b/area_unix.go
index c142769..909d288 100644
--- a/area_unix.go
+++ b/area_unix.go
@@ -159,6 +159,11 @@ func finishMouseEvent(widget *C.GtkWidget, data C.gpointer, me MouseEvent, mb ui
 // convenience name to make our intent clear
 const continueEventChain C.gboolean = C.FALSE
 
+// checking for a mouse click that makes the program/window active is meaningless on GTK+: it's a property of the window manager/X11, and it's the WM that decides if the program should become active or not
+// however, one thing is certain: the click event will ALWAYS be sent (to the window that the X11 decides to send it to)
+// I assume the same is true for Wayland
+// thanks Chipzz in irc.gimp.net/#gtk+
+
 //export our_area_button_press_event_callback
 func our_area_button_press_event_callback(widget *C.GtkWidget, event *C.GdkEvent, data C.gpointer) C.gboolean {
 	// clicking doesn't automatically transfer keyboard focus; we must do so manually (thanks tristan in irc.gimp.net/#gtk+)
diff --git a/todo.md b/todo.md
index 9f14f1a..313824c 100644
--- a/todo.md
+++ b/todo.md
@@ -20,7 +20,6 @@ WINDOWS:
 
 UNIX:
 - double-check to make sure MouseEvent.Held[] is sorted on Unix after we figure out how to detect buttons above button 5
-- figure out why I don't need to explicitly enable click on activate so I can document it
 - david wendt is telling me he's getting frequent crashes on his end with the GTK+ amd64 build...
 	TODO re-evaluate; I think I fixed them all ages ago now
 - when resizing a GTK+ window smaller than a certain size, the controls inside will start clipping in bizarre ways (the horizontal scrollbar in Area will disappear smoothly; etc.)