2 files changed, 12 insertions, 3 deletions
diff --git a/DOCS/man/af.rst b/DOCS/man/af.rst
index bc25a9f7b3..b56fc919a1 100644
--- a/DOCS/man/af.rst
+++ b/DOCS/man/af.rst
@@ -15,6 +15,9 @@ syntax is:
     wrapper, which gives you access to most of libavfilter's filters. This
     includes all filters that have been ported from MPlayer to libavfilter.
 
+    The ``--vf`` description describes how libavfilter can be used and how to
+    workaround deprecated mpv filters.
+
 See ``--vf`` group of options for info on how ``--af-defaults``, ``--af-add``,
 ``--af-pre``, ``--af-del``, ``--af-clr``, and possibly others work.
 
diff --git a/DOCS/man/vf.rst b/DOCS/man/vf.rst
index 2d53fc4ce2..64e5c0c0cd 100644
--- a/DOCS/man/vf.rst
+++ b/DOCS/man/vf.rst
@@ -49,13 +49,14 @@ normal filter parameters.
 
 .. note::
 
-    To get a full list of available video filters, see ``--vf=help``.
+    To get a full list of available video filters, see ``--vf=help`` and
+    http://ffmpeg.org/ffmpeg-filters.html .
 
     Also, keep in mind that most actual filters are available via the ``lavfi``
     wrapper, which gives you access to most of libavfilter's filters. This
     includes all filters that have been ported from MPlayer to libavfilter.
 
-    Most filters are deprecated in some ways, unless they're only available
+    Most builtin filters are deprecated in some ways, unless they're only available
     in mpv (such as filters which deal with mpv specifics, or which are
     implemented in mpv only).
 
@@ -66,6 +67,11 @@ normal filter parameters.
     everything accepted by vf_lavfi's ``graph`` option will be accepted by
     ``--vf``.)
 
+    You can also prefix the filter name with ``lavfi-`` to force the wrapper.
+    This is helpful if the filter name collides with a deprecated mpv builtin
+    filter. For example ``--vf=lavfi-scale=args`` would use libavfilter's
+    ``scale`` filter over mpv's deprecated builtin one.
+
 Video filters are managed in lists. There are a few commands to manage the
 filter list.
 
@@ -92,7 +98,7 @@ With filters that support it, you can access parameters by their name.
     Sets a named parameter to the given value. Use on and off or yes and no to
     set flag parameters.
 
-Available filters are:
+Available mpv-only filters are:
 
 ``crop[=w:h:x:y]``
     Crops the given part of the image and discards the rest. Useful to remove