Merged silc_1_0_branch to trunk.
[silc.git] / apps / irssi / docs / help / in / kill.in
index 338871d9b2600740f3b4f97826555c2ac5963efc..3593aaf3c1b3e47eb981fd581a87c5e30d80adfb 100644 (file)
@@ -1,18 +1,39 @@
 
 @SYNTAX:kill@
 
-IRC operator command.
+This command can be used for two purpose:  SILC operator may use it to
+remove a client from the network, or user may use it to remove its own
+client entries from the network.  If you are not SILC operator you cannot
+use this command to remove anybody else except yourself from the network.
+Only SILC operator is able to kill other clients from the network.
 
-KILL is used to forcibly remote a client from the irc network. 
-It works similarly to KICK, except that a reason must be 
-given (even if it is meaningless or flat-out wrong). 
+Killing own client entry from network:
 
-In general, KILL is useful only as a warning tool for abusive 
-users. Modern irc clients (this one included) have automated 
-means for reconnecting to a server after a disconnection (whether 
-due to a KILL or something else), so KILL is by no means a 
-permanent solution. It is not intended as a means for personal 
-vendettas; this practice is generally frowned upon. 
+When killing your own client entry you must provide -pubkey option to the
+command. For killing your own client from network you also must be
+connected to the same server as your own client entry (the client entry
+may be for example detached client entry).  If you are not connected to
+the same server you won't be able to kill the client.  Also, if you have
+changed or lost your old public key pair you won't be able to kill the
+client.
 
-See also: OPER
+Killing as SILC Operator:
+
+Before killing you must elevate your privileges to SILC Operator by using
+the /SILCOPER command.  After that you can kill a client.  When using this
+command as SILC operator -pubkey option has no effect and can be omitted.
+
+Examples:
+
+        /KILL myself -pubkey
+
+            Kill yourself with nickname "myself" from network.
+
+        /SILCOPER user
+        /KILL someclient You have been killed
+
+            Become SILC operator and kill client named
+            "someclient", with comment "You have been killed".
+
+See also: OPER, SILCOPER