commit - 19cb29da514a397268f2965c08496a7b6ff89aa0
commit + 78978994dfeab446f45817ec78c0e1c9aced3acc
blob - f21073abb86d16b12957dd2e2a8dd8743abcd37e
blob + 1f86cef71748f51d5a626290e714a0ae8517d7ef
--- doc/Commands.txt
+++ doc/Commands.txt
@@ -386,12 +386,18 @@ Status and Informational Commands
 	 - RFC 2812, 3.6.1 "Who query"
 
 - WHOIS
-	WHOIS [<server>] <nicknames>
+	WHOIS [<target>] <mask>[,<mask>[,...]]
 	.
-	Returns information about the comma-separated list of <nicknames>.
+	Query information about users matching the <mask> parameter(s) as seen
+	by the server <target>; up to 3 <masks> are supported.
 	.
-	If <server> is given, the command is forwarded to it for processing.
+	<target> can be a server name, the nickname of a client connected to a
+	specific server, or a mask matching a server name in the network. The
+	server of the current connecion is used when <target> is omitted.
 
+	References:
+	 - RFC 2812, 3.6.2 "Whois query"
+
 - WHOWAS
 	WHOWAS <nickname> [<count> [<server>]]
 	.