commit - 1a5e08f3f6d240f865434e9274f01e6f39a704cb
commit + 7c7fc8b5c4d6e7d6be3cf840688c3e34a8cb05a3
blob - e38f03f67147c7d2211fbd2e91db781b49be2655
blob + 2ea533a0dca75d45854f2ab7c7736fbcc7db2681
--- doc/Commands.txt
+++ doc/Commands.txt
@@ -303,18 +303,26 @@ Status and Informational Commands
 	 - RFC 2812, 3.2.5 "Names message"
 
 - STATS
-	STATS <flag> [<server>]
+	STATS [<query> [<target>]]
 	.
-	Returns statistics about the current server, or of a specified <server>.
+	Show statistics and other information of type <query> of a particular
+	IRC server in the network.
 	.
-	STATS flags:
+	The following <query> types are supported (case-insensitive):
 	.
-	g = G-Lines (Network-wide bans)
-	k = K-Lines (Server-local bans)
-	l = Link status (Parent server and own link)
-	m = IRC command status (usage count)
-	u = Server uptime
+	 - g  Network-wide bans ("G-Lines").
+	 - k  Server-local bans ("K-Lines").
+	 - l  Link status (parent server and own link only).
+	 - m  Command usage count.
+	 - u  Server uptime.
+	.
+	<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.4.4 "Stats message"
+
 - TIME
 	TIME [<server>]
 	.