added re-entrant functions
added notes on kill, raise, alarm and pause