From the NannyMUD documentation

LAST CHANGE

2000-12-12

FUNCTION

NAME
        _signal_gotten - _signal_gotten - tell something it was given an object.


LOCATION
        Can be placed in any object, ie living objects, rooms or containers

SYNTAX
        void _signal_gotten(object given_object);

DESCRIPTION
        When a player gives a monster an item, this function is
        called in the monster after the object has been transferred.
        As always, never assume that the given_object exists, it might
        be 0.


EXAMPLE
        // A cookie-monster:

        void _signal_gotten(object o) {
          if( o && (o->id("cookie")) ) {
            tell_room(environment(this_object()),
        	      "The cookie monster hapily eats the cookie.\n");
            destruct(o);
          }
        }