# $EPIC: key.txt,v 1.2 2006/08/01 03:55:07 sthalik Exp $
======Synopsis:======
$__key__(<channel list>)

======Technical:======
   * If the <channel list> argument is omitted, the current channel is used.  THIS MAY NOT BE THE CORRECT CHANNEL IN AN /[[ON]]!
   * <channel list> is taken as a word list (space separated) of channel names.  The asterisk ("*") is a special channel name that refers to the current window's current channel.  THIS MAY NOT BE THE CORRECT CHANNEL IN AN /[[ON]]!
   * The return value is a word list of channel keys corresponding in order to <channel list>.  If a specified channel in <channel list> does not have a key, the asterisk ("*") character will indicate that there is "no key".
   * You must be on the channel.
   * Before the /[[ON]] [[on CHANNEL_SYNC|CHANNEL_SYNC]] for the channel is thrown, this function may return "no key" ("*");
   * Keys are not supposed to support spaces, so we don't worry about surrounding the keys with double quotes.

======Practical:======
This function is used to fetch a channel's key.  Any number of channels
may be specified, though the output could be confusing if only some
actually have a key.  You must be on the channel(s) specified for the
function to have any effect.

======Returns:======
A list of channel keys for a list of given channels.  The "*" is used
as an indicator of "no key" for the channel.  There shouldn't be any
error condition returned by this function.

======History:======
This function first appeared in "+4" (post-ircII, pre-EPIC).  Support
for the default argument and for "*" first appeared in "+5".