demux: make hysteresis-secs respect cache-secs

currently hysteresis-secs only works when the demuxer-max-bytes fills
up. but it's possible for the cache-secs/demuxer-readahead-secs to be
reached first.

in those cases, hysteresis-secs doesn't work and keeps buffering
non-stop. but the goal of this option was to save power by avoiding
non-stop buffering so go ahead and make it respect cache-secs as well.

additionally remove some redundant repetition from the docs.

1 files changed, 4 insertions, 6 deletions

diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index 351294b110..a4fb20f8a0 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -3908,18 +3908,16 @@ Demuxer
     timestamps.)
 
 ``--demuxer-hysteresis-secs=<seconds>``
-    Once the ``--demuxer-max-bytes`` limit is reached, this value can be used
+    Once the demuxer limit is reached (``--demuxer-max-bytes``,
+    ``--demuxer-readahead-secs`` or ``--cache-secs``), this value can be used
     to specify a hysteresis before the demuxer will buffer ahead again. This
     specifies the maximum number of seconds from the current playback position
     that needs to be remaining in the cache before the demuxer will continue
     buffering ahead.
 
     For example, with a value of 10 seconds specified, the demuxer will buffer
-    ahead up to ``--demuxer-max-bytes`` and won't start buffering ahead again
-    until there is only 10 seconds of content left in the cache. When the
-    demuxer starts buffering ahead again, it will buffer ahead up to
-    ``--demuxer-max-bytes`` and stop until there's only 10 seconds of content
-    remaining in the cache, and so on.
+    ahead up to the demuxer limit and won't start buffering ahead again until
+    there is only 10 seconds of content left in the cache.
 
     This can provide significant power savings and reduce load by making the
     demuxer only buffer ahead in chunks at a time rather than buffering ahead