A
          / \      _             Play Now                         Nemesis on 
          | |     | |  _______   _        _   _______    _______   _    _______
          | |\    | | |   ____| |  \    /  | |   ____|  /   ____| | |  /   ____|
 /-------/-------------------------------------------------------------------,
O= Home <=XX|  About  News  Pics  Adventurers  Wizards  Download  Connect     >
 \-------\-------------------------------------------------------------------'
          | |   \   | |  |____  | |      | | |  |____   ___ \  \  | |  ___ \  \
          | |     \_| |_______| |_|      |_| |_______| |_______/  |_| |_______/
          \ /
           V  

Documentation Area

Document Path: /doc/living/wield

Name: wield - force a living to wield a weapon

Syntax:
	wield(object weapon)

Description:
	The wield function makes a living wield a weapon. If it is already
	wielding one, it unwields it. This function is mainly used by the
	wield command. The player is informed about this action.

Return value: none

Note:
	IMPORTANT: This is only the half of the truth! If a player wields
	a weapon, the player uses the command "wield". This command comes
	from the weapon. And the weapon calls in the player this function
	here: wield(object weapon). Now if you use it as described here,
	the weapon is only wielded "half": The monster wields the weapon
	but the weapon does not know about it. Therefore if you look at
	the wielder the weapon is not "(wielded)". If you want this, use
	command().

Examples:
	object weapon=clone_object("lib/weapon/sword");
	transfer(weapon, this_player());
	this_player()->wield(weapon);

See also:
living/stop_wielding
build/weapon
living/wear
efun/command
helpdir/wield