Syntax rewrite of U-Z commands

Rewrote the syntax documentation of U-Z commands.

1 files changed, 23 insertions, 8 deletions

diff --git a/docs/help/in/whois.in b/docs/help/in/whois.in
index 56ca30e4..b2801c5a 100644
--- a/docs/help/in/whois.in
+++ b/docs/help/in/whois.in
@@ -1,15 +1,30 @@
 
+%9Syntax:%9
+
 @SYNTAX:whois@
 
-Shows whois information of the specified nick.
-By default, this is aliased to /WI.
+%9Parameters:%9
+
+    -<server tag>:    The server tag the target nickname is on.
+
+    The remote server to query and the nicknames; if no remote server is given,
+    the server you are connected to will be used. If no nickname is given, you
+    will query yourself.
+
+%9Description:%9
+
+    Displays information about users in the specified channel; you may give the
+    same nickname as the argument twice to also query the idle time.
+
+    If the nickname is not online, the WHOWAS command will be automatically
+    performed.
 
-/WHOIS nick1 nick1 also queries the idle time of
-the user. This is aliased to /WII by default.
+%9Examples:%9
 
-If given nick is not in the IRC, irssi automatically
-sends a WHOWAS query. Read carefully the reply to see
-if it is a WHOIS or WHOWAS reply.
+    /WHOIS
+    /WHOIS mike
+    /WHOIS ircsource.irssi.org bob
+    /WHOIS sarah sarah
 
-See also: WHO, CHANNEL
+%9See also:%9 CHANNEL, NAMES, WHO, WHOWAS