commit 18ecc2fd811d3419c597fc31663f3f4a0e14824b
from: Alexander Barton <alex@barton.de>
date: Sun Feb 03 17:59:44 2013 UTC

Commands.txt: Add description for the "CAP" command

commit - 73fded75150a72c68b4c382d90e6d7c3374d5f6c
commit + 18ecc2fd811d3419c597fc31663f3f4a0e14824b
blob - c6e063785a8fb32f73574c25ebb7e7115b5b7acd
blob + ac77c6503b73774e694364f91a70f89a1bd6ccfe
--- doc/Commands.txt
+++ doc/Commands.txt
@@ -46,8 +46,42 @@ Connection Handling Commands
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 - CAP
-	See doc/Capabilities.txt
+	CAP LS
+	CAP LIST
+	CAP REQ <capabilities>
+	CAP ACK <capabilities>
+	CAP NAK <capabilities>
+	CAP CLEAR
+	CAP END
+	.
+	List, request, and clear "IRC Capabilities".
+	.
+	Using this command, an IRC client can request additional "IRC
+	capabilities" during login or later on, which influences the
+	communication between server and client. Normally, these commands
+	aren't directly used by humans, but automatically by their client
+	software. And please note that issuing such commands manually can
+	irritate the client software used, because of the "non-standard"
+	behavior of the server!
+	.
+	- CAP LS: list all available capabilities.
+	- CAP LIST: list active capabilities of this connection.
+	- CAP REQ: Request particular capabilities.
+	- CAP ACK: Acknowledge a set of capabilities to be enabled/disabled.
+	- CAP NAK: Reject a set of capabilities.
+	- CAP CLEAR: Clear all set capabilities.
+	- CAP END: Indicate end of capability negotiation during login,
+	  ignored in an fully registered session.
 
+	Please note that the <capabilities> must be given in a single
+	parameter but whitespace separated, therefore a command could look
+	like this: "CAP REQ :capability1 capability2 capability3" for example.
+
+	References:
+	 - <http://ircv3.atheme.org/specification/capability-negotiation-3.1>
+	 - <http://ngircd.barton.de/doc/Capabilities.txt>
+	 - doc/Capabilities.txt
+
 - CHARCONV
 	See doc/Protocol.txt