commit - b6e6e2e1da632a022abf7530ed028ba79d453614
commit + 5b8f13a4a975a7b60d44fa2d3817409feb234f16
blob - 642dfb0b09db8a360b7627090396f3475217f00c
blob + f23d99d8401ab818c823aaba50d470897984eab9
--- doc/Commands.txt
+++ doc/Commands.txt
@@ -342,13 +342,18 @@ Status and Informational Commands
 	of a specific <server>, in a similar method to traceroute.
 
 - USERHOST
-	USERHOST <nicknames>
+	USERHOST <nickname> [<nickname> [...]]
 	.
-	Show the user-host of <nicknames> (seperated by space).
-	"-" means <nick> is away,
-	"+" means <nick> is available,
-	"*" indicates your connection.
+	Show flags and the hostmasks (<user>@<host>) of the <nickname>s,
+	seperated by spaces. The following flags are used:
+	.
+	 - "-"  The client is "away" (the mode "+a" is set on this client).
+	 - "+"  Client seems to be available, at least it isn't marked "away".
+	 - "*"  The client is an IRC operator (the mode "+o" is set).
 
+	References:
+	 - RFC 2812, 4.8 "Userhost message"
+
 - VERSION
 	VERSION [<server>]
 	.