aboutsummaryrefslogtreecommitdiffhomepage
path: root/DOCS
diff options
context:
space:
mode:
authorGravatar wm4 <wm4@nowhere>2016-11-22 15:38:01 +0100
committerGravatar wm4 <wm4@nowhere>2016-11-22 15:54:45 +0100
commit7201fd7d08dd7f240e6f7c2584809bb4a723ab21 (patch)
tree3e53e811029fa31614ac5fee9dc3ecedabaabf68 /DOCS
parent78f76bdddd1df33fb76d9779d156bab66b5a81c1 (diff)
command: redefine some deprecated properties
As threatened by the API changes document. We can actually keep the deprecated --playlist-pos and --cache options, since they are aliases and not used by the corresponding properties. They are inconsistent, but do no harm. Keep them for now for the sake of the command line user. mpv_identify.sh partially stopped working, because it was never updated. The shell magic can't deal with property names that contain "/", so we can't replace "samplerate" with "audio-params/samplerate" - just remove these properties. (How about you use ffprobe?)
Diffstat (limited to 'DOCS')
-rw-r--r--DOCS/interface-changes.rst9
-rw-r--r--DOCS/man/input.rst7
2 files changed, 12 insertions, 4 deletions
diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst
index 5021bded66..e082b36a9d 100644
--- a/DOCS/interface-changes.rst
+++ b/DOCS/interface-changes.rst
@@ -21,6 +21,15 @@ Interface changes
--- mpv 0.23.0 ---
- remove deprecated vf_vdpaurb (use "--hwdec=vdpau-copy" instead)
+ - the following properties now have new semantics:
+ - "demuxer" (use "current-demuxer")
+ - "fps" (use "container-fps")
+ - "idle" (use "idle-active")
+ - "cache" (use "cache-percent")
+ - "audio-samplerate" (use "audio-params/samplerate")
+ - "audio-channels" (use "audio-params/channel-count")
+ - "audio-format" (use "audio-codec-name")
+ (the properties equivalent to the old semantics are in parentheses)
--- mpv 0.22.0 ---
- the "audio-device-list" property now sets empty device description to the
device name as a fallback
diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst
index 508e7dd252..70a05dcaef 100644
--- a/DOCS/man/input.rst
+++ b/DOCS/man/input.rst
@@ -2147,10 +2147,9 @@ caveats with some properties (due to historical reasons):
Strictly speaking, option access via API (e.g. ``mpv_set_option_string()``)
has the same problem, and it's only a difference between CLI/API.
-``demuxer``, ``idle``, ``length``, ``audio-samplerate``, ``audio-channels``, ``audio-format``, ``fps``, ``cache``, ``playlist-pos``, ``chapter``
- These behave completely different as property, but are deprecated (newer
- aliases which don't conflict have been added). After the deprecation period
- they will be changed to the proper option behavior.
+``playlist-pos``, ``chapter``
+ These properties behave different from the deprecated options with the same
+ names.
Property Expansion
------------------