network/youtube-dl: Updated for version 2016.09.08.

Signed-off-by: Dimitris Zlatanidis <d.zlatanidis@gmail.com>

1 files changed, 37 insertions, 1 deletions

diff --git a/network/youtube-dl/youtube-dl.1 b/network/youtube-dl/youtube-dl.1
index 73ae62c2f72d0..b52c7a84804a6 100644
--- a/network/youtube-dl/youtube-dl.1
+++ b/network/youtube-dl/youtube-dl.1
@@ -103,6 +103,11 @@ Do not mark videos watched (YouTube only)
 Do not emit color codes in output
 .RS
 .RE
+.TP
+.B \-\-abort\-on\-unavailable\-fragment
+Abort downloading when some fragment is not available
+.RS
+.RE
 .SS Network Options:
 .TP
 .B \-\-proxy \f[I]URL\f[]
@@ -272,7 +277,12 @@ Number of retries (default is 10), or "infinite".
 .TP
 .B \-\-fragment\-retries \f[I]RETRIES\f[]
 Number of retries for a fragment (default is 10), or "infinite" (DASH
-only)
+and hlsnative only)
+.RS
+.RE
+.TP
+.B \-\-skip\-unavailable\-fragments
+Skip unavailable fragments (DASH and hlsnative only)
 .RS
 .RE
 .TP
@@ -1663,6 +1673,32 @@ Each subsequent run will only download new videos if any:
 youtube\-dl\ \-\-download\-archive\ archive.txt\ "https://www.youtube.com/playlist?list=PLwiyx1dc3P2JR9N8gQaQN_BCvlSlap7re"
 \f[]
 .fi
+.SS Should I add \f[C]\-\-hls\-prefer\-native\f[] into my config?
+.PP
+When youtube\-dl detects an HLS video, it can download it either with
+the built\-in downloader or ffmpeg.
+Since many HLS streams are slightly invalid and ffmpeg/youtube\-dl each
+handle some invalid cases better than the other, there is an option to
+switch the downloader if needed.
+.PP
+When youtube\-dl knows that one particular downloader works better for a
+given website, that downloader will be picked.
+Otherwise, youtube\-dl will pick the best downloader for general
+compatibility, which at the moment happens to be ffmpeg.
+This choice may change in future versions of youtube\-dl, with
+improvements of the built\-in downloader and/or ffmpeg.
+.PP
+In particular, the generic extractor (used when your website is not in
+the list of supported sites by
+youtube\-dl (http://rg3.github.io/youtube-dl/supportedsites.html) cannot
+mandate one specific downloader.
+.PP
+If you put either \f[C]\-\-hls\-prefer\-native\f[] or
+\f[C]\-\-hls\-prefer\-ffmpeg\f[] into your configuration, a different
+subset of videos will fail to download correctly.
+Instead, it is much better to file an issue (https://yt-dl.org/bug) or a
+pull request which details why the native or the ffmpeg HLS downloader
+is a better choice for your use case.
 .SS Can you add support for this anime video site, or site which shows
 current movies for free?
 .PP