From b12a2872277ccfc9fed347cb1f3c576f61713b55 Mon Sep 17 00:00:00 2001 From: wm4 Date: Sun, 21 Sep 2014 11:10:52 +0200 Subject: 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: ```` 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]]`` -- cgit v1.2.3