From 70d1e7e560acf0aa258cbdee0e2562c677d56f46 Mon Sep 17 00:00:00 2001
From: wm4 <wm4@nowhere>
Date: Fri, 24 May 2019 20:09:52 +0200
Subject: [PATCH] manpage: document why Vorbis backward playback does not work

The only reasonable solution to this is probably to make discarding of
preroll frames based on timestmaps, instead of frame/packet count. But
then you get issues with video and its dumb timestamp reordering. So for
now, fuck it.
---
 DOCS/man/options.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst
index 7619a4e49c..7b6983d979 100644
--- a/DOCS/man/options.rst
+++ b/DOCS/man/options.rst
@@ -487,6 +487,13 @@ Playback Control
       A workaround is to remux to a format like mkv, which enforces packet
       boundaries. Making mpv cache the entire file in memory also works.
 
+    - Backward playback with Vorbis does not work. libavcodec's decoder
+      discards the first Vorbis packet (after each decoder reset), and the
+      mechanism behind ``--audio-reversal-buffer`` assumes that it strictly
+      outputs a frame for each packet fed to it (the mechanism discards output
+      based on frame count, not timestamps). Since this tries to decode each
+      frame on its own, the player never gets a usable audio frame.
+
     Tuning:
 
     - Remove all ``--vf``/``--af`` filters you have set. Disable deinterlacing.