.\"generic message delivery function
.TH message 3

.SH NAME
message() - deliver messages to "living" objects

.SH SYNOPSIS
void message(string class, string message, mixed target, mixed exclude);

.SH DESCRIPTION
message calls catch_message(string message, string class) in all objects
in the target list excluding those in the exclude list. This basically
tells the object the message.
.PP
Message is a string containing the message to be sent
.PP
Class is the type of message (used for clients and such). An example
would be 'combat', 'shout', 'emergency' etc.
.PP
target is a list of objects to be sent the message. This can be either a 
single object string or object pointer, or may be an array of either.
If a target is non living all objects in it's environment will receive
the message.
.PP
Exclude is a list of objects that should not receive the message. This
can either be one object or an array of objects.

.SH SEE ALSO
write(3), shout(3), tell(3).