[FFmpeg-cvslog] doc/protocols: document HTTP protocol cookie support

[Micah Galizia]

ffmpeg | branch: master | Micah Galizia <micahgalizia at gmail.com> | Sun Jan 13 21:33:20 2013 -0500| [10315b1cb81770212ed68f4d742a3ffbe81d5dbf] | committer: Stefano Sabatini

doc/protocols: document HTTP protocol cookie support

Signed-off-by: Stefano Sabatini <stefasab at gmail.com>

> http://git.videolan.org/gitweb.cgi/ffmpeg.git/?a=commit;h=10315b1cb81770212ed68f4d742a3ffbe81d5dbf
---

 doc/protocols.texi |   19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/doc/protocols.texi b/doc/protocols.texi
index 6fdd08d..9940b67 100644
--- a/doc/protocols.texi
+++ b/doc/protocols.texi
@@ -164,8 +164,27 @@ not specified.
 
 @item mime_type
 Set MIME type.
+
+ at item cookies
+Set the cookies to be sent in future requests. The format of each cookie is the
+same as the value of a Set-Cookie HTTP response field. Multiple cookies can be
+delimited by a newline character.
 @end table
 
+ at subsection HTTP Cookies
+
+Some HTTP requests will be denied unless cookie values are passed in with the
+request. The @option{cookies} option allows these cookies to be specified. At
+the very least, each cookie must specify a value along with a path and domain.
+HTTP requests that match both the domain and path will automatically include the
+cookie value in the HTTP Cookie header field. Multiple cookies can be delimited
+by a newline.
+
+The required syntax to play a stream specifying a cookie is:
+ at example
+ffplay -cookies "nlqptid=nltid=tsn; path=/; domain=somedomain.com;" http://somedomain.com/somestream.m3u8
+ at end example
+
 @section mmst
 
 MMS (Microsoft Media Server) protocol over TCP.