# $EPIC: on_new_nickname.txt,v 1.3 2006/08/19 02:42:38 sthalik Exp $
======Synopsis:======
[[on]] [<modes>]new_nickname [<serial#>] [-|^]<match> { <action> }

======Description:======
This hook is triggered whenever your current nickname is no longer 
acceptable and a new one must be created.  It is expected that you would
use the [[NICK]] command in the <action> of this hook.  If you do not
hook this, the client chooses a new one for you.

======Parameters:======
|$0 |The server for which we need a new nickname|
|$1 |The actual current nickname (or "*" if we don't have one)|
|$2 |The current "pending" nickname (or "*" if we don't have one)|

======History:======
The [[ON]] __NEW_NICKNAME__ hook first appeared in EPIC5-0.0.3.