SYNOPSIS
	void tell_room(object ob, string str)
	void tell_room(object ob, string str, object *exclude)
	void tell_room(object ob, mixed *msg)
	void tell_room(object ob, mixed *msg, object *exclude)

DESCRIPTION
	Send a message str to all living objects in the room ob. ob
	can also be the name of the room given as a string. If a
	receiving object is not a interactive user the lfun
	catch_tell() of the object will be invoked with the message as
	argument. If living objects define catch_tell(), the string
	will also be sent to that instead of being written to the
	user.
	If array *exclude is given, all objects contained in
	*exclude are excluded from the message str.

	If the second arg is an array, catch_msg() will be called in
	all listening livings.

EXAMPLES
	tell_object(environment(this_player()), "Hi!\n");
	
	Just send a simple "Hi!" to all livings in the current.
	
	Object 1 (living):
	   void catch_tell(string str) {
	      write("Received: "+str+"\n");
	   }
	Object 2:
	   void func() {
	      ...
	      tell_room(environment(this_player()), "HiHo!\n");
	      ...
	   }
	
	This examples shows how tell_room() together with catch_tell() works.

SEE ALSO
	write(E), shout(E), say(E), tell_object(E), catch_tell(A),
	catch_msg(A)
