From the NannyMUD documentation

LAST CHANGE

2000-12-11

FUNCTION


NAME

        move_object - move an object somewhere

SYNTAX

	void move_object(object obj, object dest)

DESCRIPTION

	Moves the object 'obj' to the destination indicated by 'dest'.

	When an object moves from a destination all the commands it has
	defined in nearby objects using add_action through init, will be
	automatically removed. If this_object is a living object then
	all commands from nearby objects will be removed automatically.

	Upon entering the destination object each living object which becomes
	nearby will be set to this_player respectively and init will be run
	in the entering object. Thus letting it add its commands with 
	add_action to each nearby living object.

	If the entering object is itself living, then this_player will be
	set to the entering object and init will be called in each object
	already in the destination. Init will also be called in the
	destination object which is normally a room.

NOTE

	As init is called from 'within' the move_object function, care must
	be taken that an infinit loop is not created by moving the wrong
	object within an init routine. If you are doubtful, never move
	an object in init.

SEE ALSO

        add_action in efun/object_related/add_action

SEE ALSO

        enable_commands in efun/object_related/enable_commands

SEE ALSO

        disable_commands in efun/object_related/disable_commands

SEE ALSO

        this_player in efun/object_related/this_player