Lfun:	use_equipment - make a monster use a weapon or armour

Synopsis:
	void use_equipment(object ob)

Description:
	The use_equipment routine makes the monster wield weapons resp.
	wear armours. If the given object has a lfun weapon_class and
	a lfun armour_class, the object will be wielded or worn resp.
	the monster trys to wear the armour. If another armour of the
	same type is alreay worn, it will fail. If there is another
	weapon wielded before, this will be unwielded. Both - wield an
	wear - is done via the efun 'command'.

	It is used by pick_any_obj - see 'man monster/pick_any_obj' and
	'man monster/set_random_pick'. But it also can be used in
	combination with notify_item_enter etc.

Return value:
	none

Examples:
	object knife = clone_object("lib/obj/knife3");
	use_equipment(knife);

Note:
	use_equipment was extracted from pic_any_obj on Mar 1st 2016.
	

See also: monster/set_random_pick, monster/pick_any_obj, object/notify_item_enter, efun/command