From b24a865d9bcc7f716a81fd218a3b637faee13f0e Mon Sep 17 00:00:00 2001
From: Carlos Garnacho <carlosg@gnome.org>
Date: Tue, 23 Aug 2016 20:31:29 +0200
Subject: [PATCH] GtkEventController: Add some comment describing the
 filter_event private vfunc

It might not be entirely clear what the boolean return value means.

https://bugzilla.gnome.org/show_bug.cgi?id=770026
---
 gtk/gtkeventcontrollerprivate.h | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/gtk/gtkeventcontrollerprivate.h b/gtk/gtkeventcontrollerprivate.h
index 2f66ecccbc..f84719846a 100644
--- a/gtk/gtkeventcontrollerprivate.h
+++ b/gtk/gtkeventcontrollerprivate.h
@@ -37,6 +37,9 @@ struct _GtkEventControllerClass
 
   /*<private>*/
 
+  /* Tells whether the event is filtered out, %TRUE makes
+   * the event unseen by the handle_event vfunc.
+   */
   gboolean (* filter_event) (GtkEventController *controller,
                              const GdkEvent     *event);
   gpointer padding[10];