Syntax documentation rewrite for J-K commands

Rewrote the syntax documentation for all commands starting with the
letters J and K.

1 files changed, 17 insertions, 11 deletions

diff --git a/docs/help/in/kill.in b/docs/help/in/kill.in
index 338871d9..37bfc584 100644
--- a/docs/help/in/kill.in
+++ b/docs/help/in/kill.in
@@ -1,18 +1,24 @@
 
+%9Syntax:%9
+
 @SYNTAX:kill@
 
-IRC operator command.
+%9Parameters:%9
+
+    The nickname to remove from the network and the reason thereof.
+
+%9Description:%9
+
+    Terminates a nickname's connection from the network; this command is
+    reserved for IRC operators.
+
+    You should not use this command for personal vendettas or for trolling;
+    these practices are generally frowned upon.
 
-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). 
+%9Examples:%9
 
-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. 
+    /KILL mike Get off my lawn
+    /KILL bob Stop breaking the network rules!
 
-See also: OPER
+%9See also:%9 DIE, OPER, WALLOPS