NAME
	transfer - move an object

SYNOPSIS
	int transfer(object item, object dest)

DESCRIPTION
	Move the object "item" to the object "dest". All kinds of tests are
	done, and a number is returned specifying the result.

RETURN VALUE
	0: Success.
	1: To heavy for destination.
	2: Can't be dropped.
	3: Can't take it out of it's container.
	4: The object can't be inserted into bags etc.
	5: The destination doesn't allow insertions of objects.
	6: The object can't be picked up.

CAVEAT
	If an object is transfered to a newly created object, make
        sure that the new object first is transfered to it's destination.

	Be sure to handle the cases when it fails.

SEE ALSO 
	move_object, drop, get, prevent_insert, can_put_and_get, add_weight

Help topics available:

_destruct	_isclone	_lock	_next_clone	_query_action
add_action	all_inventory	call_other	call_out	call_out_info
clone_object	command	creator	deep_inventory	destruct
disable_commands	enable_commands	environment	exec	file_name
find_call_out	find_living	find_object	first_inventory	function_exists
inherit	inherit_list	input_to	interactive	living
move_object	next_inventory	present	previous_object	query_verb
remove_call_out	restore_object	save_object	set_heart_beat	set_light
set_living_name	shadow	tell_object	tell_room	this_object
this_player	transfer