From b12a2872277ccfc9fed347cb1f3c576f61713b55 Mon Sep 17 00:00:00 2001
From: wm4 <wm4@nowhere>
Date: Sun, 21 Sep 2014 11:10:52 +0200
Subject: [PATCH] manpage: clarify vf_pp docs

Make the note about quoting more prominent.
Add a warning that this filter is useless for new files.
---
 DOCS/man/vf.rst | 22 ++++++++++++++--------
 1 file changed, 14 insertions(+), 8 deletions(-)

diff --git a/DOCS/man/vf.rst b/DOCS/man/vf.rst
index f73f4b963d..b8a258bbd9 100644
--- a/DOCS/man/vf.rst
+++ b/DOCS/man/vf.rst
@@ -231,12 +231,23 @@ Available filters are:
     ``<fmt>``
         Format name, e.g. rgb15, bgr24, 420p, etc. (default: 420p).
 
-``pp[=[filter1[:option1[:option2...]]/[-]filter2...]]``
+``pp=[filter string]``
     Enables the specified chain of post-processing subfilters. Subfilters must
     be separated by '/' and can be disabled by prepending a '-'. Each
     subfilter and some options have a short and a long name that can be used
-    interchangeably, i.e. ``dr``/``dering`` are the same. All subfilters share
-    common options to determine their scope:
+    interchangeably, i.e. ``dr``/``dering`` are the same.
+
+    .. note::
+
+        Unlike in MPlayer or in earlier versions, you must quote the pp string
+        if it contains ``:`` characters, e.g. ``'--vf=pp=[...]'``.
+
+    .. admonition:: Warning
+
+        This filter is most likely useless on modern HD video. It might be
+        helpful with old low-resolution files.
+
+    All subfilters share common options to determine their scope:
 
     ``a/autoq``
         Automatically switch the subfilter off if the CPU is too slow.
@@ -251,11 +262,6 @@ Available filters are:
 
         ``--vf=pp:help`` shows a list of available subfilters.
 
-    .. note::
-
-        Unlike in MPlayer or in earlier versions, you must quote the pp string
-        if it contains ``:`` characters, e.g. ``'--vf=pp=[...]'``.
-
     Available subfilters are:
 
     ``hb/hdeblock[:difference[:flatness]]``