summaryrefslogtreecommitdiffstats
path: root/DOCS/man
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2019-12-18 06:57:24 +0100
committerwm4 <wm4@nowhere>2019-12-18 06:57:24 +0100
commit5f74ed58286a1339412554932f31844ec1b64280 (patch)
treeffaf1ac28e26afb4c104ccec0fc60c6226ade3a2 /DOCS/man
parent9b9307ea9fa2a2f7f24b9ebec65ca622900af2f7 (diff)
downloadmpv-5f74ed58286a1339412554932f31844ec1b64280.tar.bz2
mpv-5f74ed58286a1339412554932f31844ec1b64280.tar.xz
options: deprecate -del for list options
I never liked that these used integer indexes. -remove should have existed from the start. This deprecation is yet another empty threat, though.
Diffstat (limited to 'DOCS/man')
-rw-r--r--DOCS/man/input.rst2
-rw-r--r--DOCS/man/mpv.rst4
-rw-r--r--DOCS/man/vf.rst6
3 files changed, 6 insertions, 6 deletions
diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst
index 8f8a5681cc..0f6ec9430e 100644
--- a/DOCS/man/input.rst
+++ b/DOCS/man/input.rst
@@ -752,7 +752,7 @@ Input Commands that are Possibly Subject to Change
cases, the second parameter is a comma separated list of filter names
or integer indexes. ``0`` would denote the first filter. Negative
indexes start from the last filter, and ``-1`` denotes the last
- filter.
+ filter. Deprecated.
<clr>
Remove all filters. Note that like the other sub-commands, this does
diff --git a/DOCS/man/mpv.rst b/DOCS/man/mpv.rst
index a96dd1149e..7ae4261605 100644
--- a/DOCS/man/mpv.rst
+++ b/DOCS/man/mpv.rst
@@ -497,7 +497,7 @@ Suffix Meaning
-pre Prepend 1 or more items (same syntax as -set)
-clr Clear the option (remove all items)
-remove Delete item if present (does not interpret escapes)
--del Delete 1 or more items by integer index
+-del Delete 1 or more items by integer index (deprecated)
-toggle Append an item, or remove if if it already exists (no escapes)
============= ===============================================
@@ -541,7 +541,7 @@ Suffix Meaning
-pre Prepend 1 or more filters (same syntax as -set)
-clr Clear the option (remove all filters)
-remove Delete filter if present
--del Delete 1 or more filters by integer index or filter label
+-del Delete 1 or more filters by integer index or filter label (deprecated)
-toggle Append a filter, or remove if if it already exists
-help Pseudo operation that prints a help text to the terminal
============= ===============================================
diff --git a/DOCS/man/vf.rst b/DOCS/man/vf.rst
index 7f0b0f9bc9..463ce07cbc 100644
--- a/DOCS/man/vf.rst
+++ b/DOCS/man/vf.rst
@@ -102,7 +102,8 @@ filter list.
with ``@``). Matching of filters works as follows: if either of the compared
filters has a label set, only the labels are compared. If none of the
filters have a label, the filter name, arguments, and argument order are
- compared.
+ compared. (Passing multiple filters is currently still possible, but
+ deprecated.)
``-vf-toggle=filter``
Add the given filter to the list if it was not present yet, or remove it
@@ -112,8 +113,7 @@ filter list.
``--vf-del=filter``
Sort of like ``--vf-remove``, but also accepts an index number. Index
numbers start at 0, negative numbers address the end of the list (-1 is the
- last). (Passing multiple filters is currently still possible, but
- deprecated.)
+ last). Deprecated.
``--vf-clr``
Completely empties the filter list.