SYNOPSIS
object snoop(object snooper)
object snoop(object snooper, object snoopee)
DESCRIPTION
Starts a snoop from 'snooper' on 'snoopee', or if 'snoopee' is not
given, terminates any snoop from 'snooper'.
Return <snoopee> on success, or 0 for a failure (including snooping
loops).
The snoop is checked with the master object for validity. It
will also fail if a snoop would result in a recursive snoop
action.
<snooper> can be an interactive player, or an object. If it is
an interactive player, the snooped text is prepended with a
'%' and send directly to the players connection. If <snooper>
is an object, the snooped text is sent in two calls to the
object's catch_tell() lfun: the first call passes just the
"%" (plus the prompt if the object changed it), the second the
actual text.
SEE ALSO
query_snoop(E), catch_tell(A)
|