Syntax documentation rewrite for J-K commands

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

1 files changed, 19 insertions, 8 deletions

diff --git a/docs/help/in/join.in b/docs/help/in/join.in
index c4e21f6e..d27597a8 100644
--- a/docs/help/in/join.in
+++ b/docs/help/in/join.in
@@ -1,15 +1,26 @@
 
+%9Syntax:%9
+
 @SYNTAX:join@
 
-   -window: Join channel, placing channel window item in currently active window
-   -invite: Join last invited channel
-   -<server tag>: Join channel on server with specified tag
+%9Parameters:%9
+
+    -window          Joins a channel in the active window.
+    -invite          Joins the channel you were last invited to.
+    -<server tag>    The server tag on which you want to join the channel.
+
+    The channel names, separated by a commma, to join and the channel key.
+
+%9Description:%9
+
+    Joins the given channels.
 
-Joins a specified channel. Channel names usually begin with #-sign,
-which may be omitted here.
+%9Examples:%9
 
-JOIN is aliased to J by default. Example: /j irssi
-(This joins to the channel #irssi)
+    /JOIN #irssi
+    /JOIN #google secret_lair
+    /JOIN -invite
+    /JOIN -freenode #github,#freenode,#irssi
 
-See also: PART, WINDOW CLOSE
+%9See also:%9 KICK, PART