Commands.txt: Update description of the "USERHOST" command

diff --git a/doc/Commands.txt b/doc/Commands.txt
index 642dfb0b09db8a360b7627090396f3475217f00c..f23d99d8401ab818c823aaba50d470897984eab9 100644 (file)
--- a/doc/Commands.txt
+++ b/doc/Commands.txt
@@ -342,12 +342,17 @@ 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>]