From d5ab5482a9b35650600ca68bcfee752995e8337b Mon Sep 17 00:00:00 2001 From: Leo Izen Date: Sun, 3 Jan 2021 12:13:35 -0500 Subject: manpage: document off-by-one loop-file behavior loop-file counts the number of zero-seeks, not playthroughs, which makes its counter off by one compared to loop-playlist. --- DOCS/man/options.rst | 5 +++++ 1 file changed, 5 insertions(+) (limited to 'DOCS') diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst index 3beda8b00d..16625fe0c4 100644 --- a/DOCS/man/options.rst +++ b/DOCS/man/options.rst @@ -392,6 +392,11 @@ Playback Control difference between the two option is that this option performs a seek on loop, instead of reloading the file. + Note that ``--loop-file`` counts the number of times it causes the player to + seek to the beginning of the file, not the number of full playthroughs. This + means ``--loop-file=1`` will end up playing the file twice. Contrast with + ``--loop-playlist``, which counts the number of full playthroughs. + ``--loop`` is an alias for this option. ``--ab-loop-a=