Path: utzoo!attcan!uunet!auspex!guy
From: guy@auspex.UUCP (Guy Harris)
Newsgroups: comp.soft-sys.andrew
Subject: Re: im_SetInteractionEvent doesn't do what the documentation says
Message-ID: <2730@auspex.UUCP>
Date: 18 Dec 89 20:35:42 GMT
References: <2715@auspex.UUCP> <sZVuck600Uk908ZkkP@andrew.cmu.edu>
Reply-To: guy@auspex.auspex.com (Guy Harris)
Organization: Auspex Systems, Santa Clara
Lines: 59

>I believe you are correct that the documentation is in error.  The
>actual behavior of SetInteractionEvent is to be called on the first user
>interaction after the time interval has expired.  In your example, the
>word "Cancelled" should stay visible until the first interaction after
>15 seconds.  You can test this out by typing ^G and then hitting the
>space bar once a second.  At some point the message should go away.

Thanks.  Yup, I tried it after sending out my message, and that's what
it does.  I put

	*.messagetimeout: 0

into my ".Xdefaults", and now it works the way I want it to.

Here's a first cut at a fix to "atk/basics/common/im.doc" (which fixes
both the bugs I noted); the description of what "timeIncrement" means
can almost certainly be improved from my version:

*** im.doc.dist	Wed Nov 15 17:14:22 1989
--- im.doc	Thu Dec 14 17:16:58 1989
***************
*** 558,564 ****
  \paragraph{Setting an interaction event}\indexi{Interaction manager++Setting 
  an interaction event} \indexi{ \italic{im_SetInteractionEvent}}
  
! \example{void im_SetInteractionEvent (im, interactionFunction, 
  interactionData, timeIncrement) 
  
  struct im *im;  
--- 558,564 ----
  \paragraph{Setting an interaction event}\indexi{Interaction manager++Setting 
  an interaction event} \indexi{ \italic{im_SetInteractionEvent}}
  
! \example{struct event *im_SetInteractionEvent (im, interactionFunction, 
  interactionData, timeIncrement) 
  
  struct im *im;  
***************
*** 571,580 ****
  
  
  \leftindent{\bold{Method description.  }  \italic{im_SetInteractionEvent 
! } sets up an interaction event.  The interactionFunction will be called with 
! the parameter interactionData when either a user interaction (mouse hit, 
! key-stroke or menu selection) occurs, or after timeIncrement seconds, which 
! ever comes first. 
  
  
  \bold{Usage.}  Be careful with this function.  Because Toolkit objects are do 
--- 571,579 ----
  
  
  \leftindent{\bold{Method description.  }  \italic{im_SetInteractionEvent 
! } sets up an interaction event.  After a delay of timeIncrement seconds, the 
! interactionFunction will be called with the parameter interactionData when the 
! next user interaction (mouse hit, key-stroke or menu selection) occurs. 
  
  
  \bold{Usage.}  Be careful with this function.  Because Toolkit objects are do