From c38a756ae50616b1431e3137141189a5588654a0 Mon Sep 17 00:00:00 2001 From: Mikael Magnusson Date: Wed, 27 Feb 2008 03:59:25 +0100 Subject: Fix some typos and style in client.c, and add a comment. Also moves a comment from many places into one place. --- openbox/event.h | 16 +++++++++++----- 1 file changed, 11 insertions(+), 5 deletions(-) (limited to 'openbox/event.h') diff --git a/openbox/event.h b/openbox/event.h index a8d1aeaf..93af6b4c 100644 --- a/openbox/event.h +++ b/openbox/event.h @@ -25,7 +25,7 @@ struct _ObClient; /*! The amount of time before a window appears that is checked for user input - to determine if the user is working in another window */ + to determine if the user is working in another window */ #define OB_EVENT_USER_TIME_DELAY (500) /* 0.5 seconds */ /*! Time at which the last event with a timestamp occured. */ @@ -42,15 +42,21 @@ void event_startup(gboolean reconfig); void event_shutdown(gboolean reconfig); /*! Make as if the mouse just entered the client, use only when using focus - follows mouse */ + follows mouse */ void event_enter_client(struct _ObClient *client); /*! Make mouse focus not move at all from the stuff that happens between these - two function calls. */ + two function calls. */ gulong event_start_ignore_all_enters(); void event_end_ignore_all_enters(gulong start); -/*! End *all* active and passive grabs on the keyboard */ +/*! End *all* active and passive grabs on the keyboard + This is called in situations where if there is a grab going on, then + we need to cancel it. If we move focus during the grab, applications + will get NotifyWhileGrabbed events and ignore them! + + Actions should not rely on being able to move focus during an + interactive grab. */ void event_cancel_all_key_grabs(); /* Halts any focus delay in progress, use this when the user is selecting a @@ -58,7 +64,7 @@ void event_cancel_all_key_grabs(); void event_halt_focus_delay(); /*! Compare t1 and t2, taking into account wraparound. True if t1 - comes at the same time or later than t2. */ + comes at the same time or later than t2. */ gboolean event_time_after(Time t1, Time t2); Time event_get_server_time(); -- cgit v1.2.3