EMOTE(2)                  SYSTEM CALLS                   EMOTE(2)

NAME
     emote - "an efun to implement the emote command

SYNOPSIS
     varargs int emote (object sender, string msg_self,
                     string  msg_others,  mixed  target,   string
     msg_target,
                     string extra);

DESCRIPTION
     This efun implements the emote command by passing the "msg_"
     strings  to  the  appropriate  players, as described in more
     detail below.

     ARGUMENTS

     sender      -  the  player  who  issued  the  emote  command
     msg_self   - the string to be parsed and sent back to sender
     msg_others - the string to be parsed and displayed to others
     in
                     the same room target     -  the  player  (or
     other living object) that receives
                     (is the victim of?) the action being emoted.
     This
                     argument may be omitted for  emoted  actions
     that
                     have no target.  msg_target - the string  to
     be parsed and displayed to the target.
                     If there is no target, this argument will be
                     ignored.  extra      - an extra string  that
     will replace "{M}" in any of the
                     "msg_" strings (see next section)

     PARSING

     Within the  msg_self  string,  certain  substrings  will  be
     automatically replaced, as follows:
         {n}     - the name of target
         {o}     - the objective form of target's name
         {p}     - the possessive form of target's name
         {M}     - the "extra" argument, as noted above
             (Note:  if either target or msg_target are not used,
     this
              efun will send msg_self back to sender without mak-
     ing the
              substitutions listed above)

     Within msg_others, the following substutions will be made:
         {N}     - the name of sender
         {O}     - the objective form of sender's name


MudOS Release 0.9         Last change:                   3-19-93

EMOTE(2)                  SYSTEM CALLS                   EMOTE(2)

         {P}     - the possessive form of sender's name
         {M}     - the argument "extra"
         {n}     - the name of target
         {o}     - the objective form of target's name
         {p}     - the possessive form of target's name

     Within msg_target, the following substitutions will be made:
         {N}     - the name of sender
         {O}     - the objective form of sender's name
         {P}     - the possessive form of sender's name
         {M}     - the argument "extra"

     RESULTS

     This efun returns 1 if there was no error.   It  will  fail,
     and  return  zero, if any of the following are true:  sender
     is omitted, sender->query_cap_name() returns zero, target is
     not  present  in  sender's  environment, target is neither a
     string nor an object, or target is not living.

SEE ALSO
     help soul

AUTHOR
     Ichabod@TMI, 1/28/93

MudOS Release 0.9         Last change:                          2