NAME
	send_message - send a message to a user

SYNOPSIS
	int send_message(string message)
	int send_message(int code)


DESCRIPTION
	In the first form, send a message to the user associated with the
	current object.	 Used by the driver object, send_message() will write
	the message on stderr.  In the second form, send_message(0) means
	turn input echoing off, and send_message(1) means turn input echoing
	on; they are only meaningful for telnet connections.  Use of
	send_message(-1) is described below.

        The function will return 0 if there is room for more messages,
        and 1 if not.  If it returns 1, the driver will call message_done()
	in this object when all messages have been sent; if this object
	calls send_message() again before message_done() has been called,
	the remainder of the previous message will be discarded.

	Calling send_message(-1) will return 0 if all messages have been
	sent, and 1 if not.  If it returns 1, the driver will call
	message_done() in this object when all messages have been sent.

	Destructing a connection object before all messages have been sent
	may cause the messages to be lost.


ERRORS
	Calling send_message() in an object that is not connected will
	result in an error.


SEE ALSO
	kfun/query_ip_number, kfun/this_user, kfun/connect, kfun/open_port,
	kfun/users
