Document:     herevents

Purpose:      Describes routines for handling Hermes events

Category:     SYSTEM
              
File:         herevents.c
             
Author:       J.P. Terlouw
            
Description:  The routines in this source allow a task to specify ("schedule")
              one or more functions to be called when Hermes generates a
              specified event. A Hermes event can be one of the following:
              - user input keyword change;
              - user input keyword cancel;
              - user input keyword reject;
              - task resume after suspend.
              These events and associated messages are defined in taskcom.h.
              
              The following routines are available:

              ScheduleHerevent     - schedule function for receiving events
              DescheduleHerevent   - deschedule function
              Herevents            - control Hermes' event generation
              HerConnect           - connect from alternative event loop
              HerSignal            - activation by alternative event loop

Related doc:  MainLoop.dc2

Updates:      Feb 22, 2010: JPT, readevent() now processes all pending events.
              Sep 03, 2010: JPT, leave select() loop on negative status.