commit 07f241ff6d3afee88d6c6b3e2ed1e195c0367c91
from: Alexander Barton <alex@barton.de>
date: Sun Feb 13 16:52:39 2011 UTC

Enhance documentation for the WEBIRC command

commit - 53fecf5a2b3e0f396b08b2a00a73eb73c46e1853
commit + 07f241ff6d3afee88d6c6b3e2ed1e195c0367c91
blob - 354b814b05888b0198868c2e0c7bee3f3b27697c
blob + 2b7e7b875d226a5586331dc7994da8ea7850a57e
--- doc/Protocol.txt
+++ doc/Protocol.txt
@@ -161,3 +161,17 @@ and therefore can't be omitted. The parameter <limit> 
 a channel has no user limit (the parameter <modes> doesn't list the "l"
 channel mode). In this case <limit> should be "0".
 
+
+II.4 Update webchat/proxy client information
+
+     Command: WEBIRC
+  Parameters: <password> <username> <hostname> <ip-address>
+     Used by: unregistered clients only
+
+The WEBIRC command is used by some Web-to-IRC gateways to set the correct
+user name and host name of users instead of their own. It must be the very
+first command sent to the server, even before USER and NICK commands!
+
+The <password> must be set in the server configuration file to prevent
+unauthorized clients to fake their identity; it is an arbitrary string.
+
blob - 1557f1845fe8e3657949f45e1c386062cdaa7661
blob + 6a97074aa94491b067ca2369845ec5f36fefdd9c
--- src/ngircd/irc-login.c
+++ src/ngircd/irc-login.c
@@ -596,8 +596,14 @@ IRC_SERVICE(CLIENT *Client, REQUEST *Req)
 
 
 /**
- * Handler for the IRC command "WEBIRC".
- * Syntax: WEBIRC <password> <username> <real-hostname> <real-IP-address>
+ * Handler for the IRC "WEBIRC" command.
+ *
+ * See doc/Protocol.txt, section II.4:
+ * "Update webchat/proxy client information".
+ *
+ * @param Client	The client from which this command has been received.
+ * @param Req		Request structure with prefix and all parameters.
+ * @returns		CONNECTED or DISCONNECTED.
  */
 GLOBAL bool
 IRC_WEBIRC(CLIENT *Client, REQUEST *Req)