diff --git a/DOCS/man/vf.rst b/DOCS/man/vf.rst
index c0614d968f..9da20942f6 100644
--- a/DOCS/man/vf.rst
+++ b/DOCS/man/vf.rst
@@ -755,11 +755,13 @@ Available filters are:
         :yes: Only deinterlace frames marked as interlaced (default).
 
     ``reversal-bug=<yes|no>``
-        :no:  Use the API as it appears to be documented. Reported to work well
-              with Mesa drivers.
-        :yes: Switch surface forward and backwards references (default). Appears
-              to work (or work better than ``no``) with Intel drivers. Matters
-              only for the advanced deinterlacing algorithms.
+        :no:  Use the API as it was interpreted by older Mesa drivers. While
+              this interpretation was more obvious and inuitive, it was
+              apparently wrong, and not shared by Intel driver developers.
+        :yes: Use Intel interpretation of surface forward and backwards
+              references (default). This is what Intel drivers and newer Mesa
+              drivers expect. Matters only for the advanced deinterlacing
+              algorithms.
 
 ``vdpaupp``
     VDPAU video post processing. Works with ``--vo=vdpau`` and ``--vo=opengl``