Update upstream source from tag 'upstream/2018.03.14'

[youtubedl] / youtube-dl.1

diff --git a/youtube-dl.1 b/youtube-dl.1
index 9ab22b088eb9f20093113f24114b551de9843ebd..b859b1de59c61f51f5cd0e76466aab6ebf3f0b42 100644 (file)
--- a/youtube-dl.1
+++ b/youtube-dl.1
@@ -11,7 +11,7 @@ youtube\-dl \- download videos from youtube.com or other video platforms
 YouTube.com and a few more sites.
 It requires the Python interpreter, version 2.6, 2.7, or 3.2+, and it is
 not platform specific.
 YouTube.com and a few more sites.
 It requires the Python interpreter, version 2.6, 2.7, or 3.2+, and it is
 not platform specific.

-It should work on your Unix box, on Windows or on Mac OS X.
+It should work on your Unix box, on Windows or on macOS.

 It is released to the public domain, which means you can modify it,
 redistribute it or use it however you like.
 .SH OPTIONS
 It is released to the public domain, which means you can modify it,
 redistribute it or use it however you like.
 .SH OPTIONS


@@ -331,6 +331,14 @@ value of SIZE.
 .RS
 .RE
 .TP
 .RS
 .RE
 .TP

+.B \-\-http\-chunk\-size \f[I]SIZE\f[]
+Size of a chunk for chunk\-based HTTP downloading (e.g.
+10485760 or 10M) (default is disabled).
+May be useful for bypassing bandwidth throttling imposed by a webserver
+(experimental)
+.RS
+.RE
+.TP

 .B \-\-playlist\-reverse
 Download playlist videos in reverse order
 .RS
 .B \-\-playlist\-reverse
 Download playlist videos in reverse order
 .RS


@@ -1066,6 +1074,15 @@ scale used depends on the webpage
 .IP \[bu] 2
 \f[C]age_limit\f[] (numeric): Age restriction for the video (years)
 .IP \[bu] 2
 .IP \[bu] 2
 \f[C]age_limit\f[] (numeric): Age restriction for the video (years)
 .IP \[bu] 2

+\f[C]is_live\f[] (boolean): Whether this video is a live stream or a
+fixed\-length video
+.IP \[bu] 2
+\f[C]start_time\f[] (numeric): Time in seconds where the reproduction
+should start, as specified in the URL
+.IP \[bu] 2
+\f[C]end_time\f[] (numeric): Time in seconds where the reproduction
+should end, as specified in the URL
+.IP \[bu] 2

 \f[C]format\f[] (string): A human\-readable description of the format
 .IP \[bu] 2
 \f[C]format_id\f[] (string): Format code specified by
 \f[C]format\f[] (string): A human\-readable description of the format
 .IP \[bu] 2
 \f[C]format_id\f[] (string): Format code specified by


@@ -1120,6 +1137,11 @@ padded with leading zeros according to the total length of the playlist
 \f[C]playlist_id\f[] (string): Playlist identifier
 .IP \[bu] 2
 \f[C]playlist_title\f[] (string): Playlist title
 \f[C]playlist_id\f[] (string): Playlist identifier
 .IP \[bu] 2
 \f[C]playlist_title\f[] (string): Playlist title

+.IP \[bu] 2
+\f[C]playlist_uploader\f[] (string): Full name of the playlist uploader
+.IP \[bu] 2
+\f[C]playlist_uploader_id\f[] (string): Nickname or id of the playlist
+uploader

 .PP
 Available for the video that belongs to some logical chapter or section:
 .IP \[bu] 2
 .PP
 Available for the video that belongs to some logical chapter or section:
 .IP \[bu] 2


@@ -1732,7 +1754,7 @@ Make sure you have correct newline
 format (https://en.wikipedia.org/wiki/Newline) in the cookies file and
 convert newlines if necessary to correspond with your OS, namely
 \f[C]CRLF\f[] (\f[C]\\r\\n\f[]) for Windows and \f[C]LF\f[]
 format (https://en.wikipedia.org/wiki/Newline) in the cookies file and
 convert newlines if necessary to correspond with your OS, namely
 \f[C]CRLF\f[] (\f[C]\\r\\n\f[]) for Windows and \f[C]LF\f[]

-(\f[C]\\n\f[]) for Unix and Unix\-like systems (Linux, Mac OS, etc.).
+(\f[C]\\n\f[]) for Unix and Unix\-like systems (Linux, macOS, etc.).

 \f[C]HTTP\ Error\ 400:\ Bad\ Request\f[] when using \f[C]\-\-cookies\f[]
 is a good sign of invalid newline format.
 .PP
 \f[C]HTTP\ Error\ 400:\ Bad\ Request\f[] when using \f[C]\-\-cookies\f[]
 is a good sign of invalid newline format.
 .PP