summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorGuido Cella <guido@guidocella.xyz>2020-12-06 20:49:34 +0100
committerDudemanguy <random342@airmail.cc>2020-12-08 17:27:14 +0000
commitd4bf179e78016f6145a7fa4a202c7f25887994e9 (patch)
treec3f2d03683ffbedd4e2356a37305c78fad9b172d /DOCS
parent7db17e627c9bbe07a6b9d3ecf52161e3999a431f (diff)
downloadmpv-d4bf179e78016f6145a7fa4a202c7f25887994e9.tar.bz2
mpv-d4bf179e78016f6145a7fa4a202c7f25887994e9.tar.xz
manpage: clarify that you can prefetch m3u8 urls
With the current wording, I thought that playlist-prefetch doesn't prefetch the next url within a playlist of m3u8 urls, but it makes a big difference, and I would have enabled it earlier if it wasn't for this paragraph. This makes it clear that you can prefetch any file, but that it won't prefill the cache with the video data. This is true for any video, there's nothing unique about HLS streams in the behavior of this option.
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/man/options.rst12
1 files changed, 7 insertions, 5 deletions
diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index 5492d1ba4d..6b4757d5c5 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -3711,15 +3711,17 @@ Demuxer
``--prefetch-playlist=<yes|no>``
Prefetch next playlist entry while playback of the current entry is ending
- (default: no). This merely opens the URL of the next playlist entry as soon
- as the current URL is fully read.
+ (default: no).
+
+ This does not prefill the cache with the video data of the next URL.
+ Prefetching video data is supported only for the current playlist entry,
+ and depends on the demuxer cache settings (on by default). This merely
+ opens the URL of the next playlist entry as soon the current URL is fully
+ read.
This does **not** work with URLs resolved by the ``youtube-dl`` wrapper,
and it won't.
- This does not affect HLS (``.m3u8`` URLs) - HLS prefetching depends on the
- demuxer cache settings and is on by default.
-
This can give subtly wrong results if per-file options are used, or if
options are changed in the time window between prefetching start and next
file played.