Merged from silc_1_0_branch.

[silc.git] / apps / irssi / docs / help / in / key.in

diff --git a/apps/irssi/docs/help/in/key.in b/apps/irssi/docs/help/in/key.in
index 9e54b7bd7daeae44477b100b5d977aeffae591f4..a14b49f1d681177ea7e0abd76f07e4664eb0355c 100644 (file)
--- a/apps/irssi/docs/help/in/key.in
+++ b/apps/irssi/docs/help/in/key.in
@@ -15,22 +15,24 @@ Types:
   MSG        The command is performed for private messages
              affecting the <nickname>.
 
-  CHANNEL    The command is performed for channel affecting
-             the <channel>.
+  CHANNEL    The command is performed for the channel indicated
+             by <channel> (* matches current channel).
 
 Commands:
 
-  set        [<key> [<cipher>] [<hmac>]]
+  set        [<key> [<cipher>] [<hmac>]] [-responder]
 
     Set the key into use.  If the <key> is provided it is used
     as the key material.  If the <key> is not provided the
     negotiated key material is used.  If the negotiation has not
     been performed this command has no effect.
 
-    If the type is `msg' and the <key> is `*' then random key
-    will be generated automatically.  The <cipher> may be set
-    for both private message and channel private keys and the
-    <hmac> may be set only to the channel private keys.
+    If the type is MSG and the <key> is `*' then random key
+    will be generated automatically.  The -responder option
+    may be used ONLY with MSG type.  One of the clients must
+    be the responder side.  The one being the responder must
+    use this option.  The clients setting the key must agree
+    on which one is the responder.
 
   unset      [<number>]
 
@@ -44,9 +46,17 @@ Commands:
   list
 
     List all private keys that has been set.  If the type is
-    `msg' and the <nickname> is ´*' then all private message
+    MSG and the <nickname> is ´*' then all private message
     keys that you've set will be listed.
 
+  change     [<number>]
+
+    This command can be used only when type is CHANNEL.  This is
+    used to change the current channel private key.  The <number>
+    may indicate what key is changed.  If it is not provided then
+    next key is changed to current channel private key.  By default
+    this command is also bound to Meta-K (Alt+Shift+k) key.
+
   agreement  [<hostname> [<port>]]
 
     Send key agreement request to remote client.  If the
@@ -82,3 +92,16 @@ Commands:
     your key agreement request.  You will see a notify on the
     screen when the reply arrives.  The <hostname> and <port> is the
     hostname and port of the remote client's key agreement server.
+
+Examples:
+
+  Set channel private key to current channel, and list all keys:
+
+    /KEY CHANNEL * set very_secret_key_this_is
+    /KEY CHANNEL * list
+    /KEY MSG nickname set secretkey
+    /KEY MSG nick set secretkey -responder
+    /KEY MSG foo agreement 10.2.1.7 5000
+    /KEY MSG bar negotiate 10.2.1.7 5000
+
+See also: WHOIS, CHANNEL, GETKEY