# $EPIC: on_action.txt,v 1.5 2012/07/04 06:30:23 jnelson Exp $
======Synopsis:======
[[on]] action

======Summary:======
Triggered by other people's [[me]] commands

======Description:======
This event is thrown whenever someone sends a [[ctcp action]] to you
or to a channel you are on.  [[Ctcp actions]] are generated by the [[me]]
and [[describe]] commands.

======Parameters:======
|$0   |Who sent the action |
|$1   |Who the action was sent to (your nickname, or a channel) |
|$2-  |Message body  |

======Default Behavior:======
If you don't supress this event, the client will format the message and
output it to the channel's window.

======Examples:======
To distinguish personal actions from those sent to a channel:
   on ^action * (sender, recvr, body) {
      if (recvr == servernick()) {
         echo *> $sender $body;
      } else if (iscurchan($recvr)) {
         echo * $sender $body;
      } else {
         echo * $sender/$recvr $body;
      };
   };

======History:======
This already existed in ircII.