summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2013-04-26 16:52:54 +0200
committerwm4 <wm4@nowhere>2013-04-26 20:44:18 +0200
commit28a971e26f7318d2081dff8c95a3844823ed7c9d (patch)
tree24828ac3c63097671da34dec8ec5118dc9c3939a /DOCS
parentca08ce77a95c91868a872671c4eca1438f905bb1 (diff)
downloadmpv-28a971e26f7318d2081dff8c95a3844823ed7c9d.tar.bz2
mpv-28a971e26f7318d2081dff8c95a3844823ed7c9d.tar.xz
options: allow using [ ] for quoting in sub-options
This is an attempt to make quoting of sub-option values less awkward, even if it works only with some shells. This is needed mainly for vf_lavfi. Also update the vf_lavfi manpage section.
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/man/en/vf.rst19
1 files changed, 13 insertions, 6 deletions
diff --git a/DOCS/man/en/vf.rst b/DOCS/man/en/vf.rst
index e534c73ec3..846d3ffac6 100644
--- a/DOCS/man/en/vf.rst
+++ b/DOCS/man/en/vf.rst
@@ -383,14 +383,21 @@ lavfi=graph[:sws_flags]
*EXAMPLE*:
- ``'--vf=lavfi="gradfun=20:30"'``
- gradfun filter with non-sensical parameters. The ``'`` quotes are
- for the shell. Otherwise, the shell would remove the ``"`` quotes.
+ ``-vf lavfi=[gradfun=20:30,vflip]``
+ gradfun filter with nonsense parameters, followed by a vflip
+ filter. (This demonstrates how libavfilter takes a graph and not
+ just a single filter.) The filter graph string is quoted with
+ ``[`` and ``]``. This requires no additional quoting or escaping
+ with some shells (like bash), while others (like zsh) require
+ additional ``"`` quotes around the option string.
+
+ ``'--vf=lavfi="gradfun=20:30,vflip"'``
+ same as before, but uses quoting that should be safe with all
+ shells. The outer ``'`` quotes make sure that the shell doesn't
+ remove the ``"`` quotes needed by mpv.
``'--vf=lavfi=graph="gradfun=radius=30:strength=20,vflip"'``
- same as before, but uses named parameters. Also a vflip filter is
- appended, demonstrating how libavfilter actually takes a graph
- description and not a single filter.
+ same as before, but uses named parameters for everything.
<sws_flags>
If libavfilter inserts filters for pixel format conversion, this