From the NannyMUD documentation

LAST CHANGE

2000-12-12

FUNCTION

NAME
        _signal_given - _signal_given - tell an object it was given or put away


LOCATION
        Any object that might be dropped.

SYNTAX
        void _signal_given();

DESCRIPTION
        When a player has given or put away something this function is
        called in the dropped object _after_ the item is moved to its
        new location.


NOTE
        Is not called when dropping things, use _signal_dropped.
        Is not called when selling things.


EXAMPLE
        //A delicate vase that may break if handled carelessly.

        inherit "/std/basic_thing";
         
        void _signal_given()
        {
          if (!random(5)) /* 20% risk of breaking. */
          {	   
            write("You clumsily destroy the vase.\n");
            set_short("a broken vase");
            set_long("The vase is cracked and large pieces are missing.\n");
            set_value(20);
          }
        }
         
        void reset()
        {
          set_name("vase");
          set_short("a delicate vase");
          set_long("A most delicate vase of the finest china, you had\n"+
        	   "better be careful with it!\n");
          set_value(400);
        }


SEE ALSO
        _signal_dropped in lfun/_signals/_signal_dropped