1 files changed, 20 insertions, 0 deletions
diff --git a/network/youtube-dl/youtube-dl.1 b/network/youtube-dl/youtube-dl.1
index cde2abf571..b27ad810f0 100644
--- a/network/youtube-dl/youtube-dl.1
+++ b/network/youtube-dl/youtube-dl.1
@@ -393,6 +393,9 @@ Use commas to download multiple formats, such as
 You can merge the video and audio of two formats into a single file
 using \f[C]\-f\ <video\-format>+<audio\-format>\f[] (requires ffmpeg or
 avconv), for example \f[C]\-f\ bestvideo+bestaudio\f[].
+Format selectors can also be grouped using parentheses, for example if
+you want to download the best mp4 and webm formats with a height lower
+than 480 you can use \f[C]\-f\ \[aq](mp4,webm)[height<480]\[aq]\f[].
 .PP
 Since the end of April 2015 and version 2015.04.26 youtube\-dl uses
 \f[C]\-f\ bestvideo+bestaudio/best\f[] as default format selection (see
@@ -680,6 +683,23 @@ youtube\-dl\ \-\-\ \-wNyEUrxzFU
 youtube\-dl\ "http://www.youtube.com/watch?v=\-wNyEUrxzFU"
 \f[]
 .fi
+.SS How do I pass cookies to youtube\-dl?
+.PP
+Use the \f[C]\-\-cookies\f[] option, for example
+\f[C]\-\-cookies\ /path/to/cookies/file.txt\f[].
+Note that cookies file must be in Mozilla/Netscape format and the first
+line of cookies file must be either \f[C]#\ HTTP\ Cookie\ File\f[] or
+\f[C]#\ Netscape\ HTTP\ Cookie\ File\f[].
+Make sure you have correct newline
+format (https://en.wikipedia.org/wiki/Newline) in cookies file and
+convert newlines if necessary to correspond your OS, namely
+\f[C]CRLF\f[] (\f[C]\\r\\n\f[]) for Windows, \f[C]LF\f[] (\f[C]\\n\f[])
+for Linux and \f[C]CR\f[] (\f[C]\\r\f[]) for Mac OS.
+\f[C]HTTP\ Error\ 400:\ Bad\ Request\f[] when using \f[C]\-\-cookies\f[]
+is a good sign of invalid newline format.
+.PP
+Passing cookies to youtube\-dl is a good way to workaround login when
+particular extractor does not implement it explicitly.
 .SS Can you add support for this anime video site, or site which shows
 current movies for free?
 .PP