[gtk+/gestures: 133/140] gesture: Add explanatory note in GtkGesture::end

[Carlos Garnacho <carlosg src gnome org>]

commit 2d428a01b02399b003a7330d6b903276537a3240
Author: Carlos Garnacho <carlosg gnome org>
Date:   Tue May 6 15:23:24 2014 +0200

    gesture: Add explanatory note in GtkGesture::end
    
    Explain that this signal may be triggered by an extra touch that causes
    the gesture to surpass GtkGesture:n-points.

 gtk/gtkgesture.c |    5 +++++
 1 files changed, 5 insertions(+), 0 deletions(-)
---
diff --git a/gtk/gtkgesture.c b/gtk/gtkgesture.c
index 10b10c2..39a56ba 100644
--- a/gtk/gtkgesture.c
+++ b/gtk/gtkgesture.c
@@ -651,6 +651,11 @@ gtk_gesture_class_init (GtkGestureClass *klass)
    * #FALSE), or the number of touch sequences became higher or lower than
    * #GtkGesture:n-points.
    *
+   * Note: @sequence might not pertain to the group of sequences that were
+   * previously triggering recognition on @gesture (ie. a just pressed touch
+   * sequence that exceeds #GtkGesture:n-points). This situation may be detected
+   * by checking through gtk_gesture_handles_sequence().
+   *
    * Since: 3.14
    */
   signals[END] =