# $EPIC: nickcomp.txt,v 1.3 2007/02/27 04:57:37 jnelson Exp $
======Synopsis:======
[[load]] nickcomp \\
/set nickcomp ON|OFF|TOGGLE \\
/set nickcomp_char <char> \\
/set nickcomp_len <number> \\
/set nickcomp_multi ON|OFF|TOGGLE

======Description:======
This script will automatically complete a partially matching nickname 
when you type it in a channel.  The usual custom on irc is to type some
person's nickname, followed by a colon, followed by a space, followed
by your message.  If you use this style, then this script will allow you
to specify the non-ambiguous part of a person's nickname and automatically
change it for you before sending it off to irc.

If you /set nickcomp ON (the default), then the nickname completion action
is automatically done each time you type to the channel.  If OFF, then no
auto-completion will be done.

If you /set nickcomp_char :  (the default) then the nickname of the person
you are speaking to should be the part before the colon.  If you use 
another character, change this setting.

If you /set nickcomp_len 3  (the default), then there must be this many
character before the colon to qualify for automatic completion.  If there
are fewer characters, it is not changed.

If you /set nickcomp_multi off (the default) and if the nickname you type
before the colon is ambiguous (expands to multiple nicknames) then the first
nick that matches will be used; if you set it to ON, then it will auto-
complete to ALL the nicknames, separated by commas.

======History:======
This script first appeared in epic5-0.3.1.