diff options
author | wm4 <wm4@nowhere> | 2020-01-07 23:08:45 +0100 |
---|---|---|
committer | wm4 <wm4@nowhere> | 2020-01-07 23:08:45 +0100 |
commit | d3cef97ad38fb027262a905bd82e1d3d2549aec7 (patch) | |
tree | 200c7c376af503ee826a50a8b812d1f0aceb316a /DOCS/interface-changes.rst | |
parent | 5b56be0e91a78565d51e69ef0df625f52c140820 (diff) | |
download | mpv-d3cef97ad38fb027262a905bd82e1d3d2549aec7.tar.bz2 mpv-d3cef97ad38fb027262a905bd82e1d3d2549aec7.tar.xz |
options: change option parsing when using a single dash
Addresses dumb things like accidentally overwriting a media file with
e.g. "mpv --log-file test.mkv" (when the user thought that --log-file
was a flag option, when it actually takes a filename). This example will
now print an error. It still works with "-log-file overwritten.mkv", but
prints a warning.
Not sure if I'm being too careful or not "radical" enough. In any case,
both the syntax that stops working and the syntax that produces a
warning now have been discouraged and were called legacy for almost a
decade.
Diffstat (limited to 'DOCS/interface-changes.rst')
-rw-r--r-- | DOCS/interface-changes.rst | 8 |
1 files changed, 8 insertions, 0 deletions
diff --git a/DOCS/interface-changes.rst b/DOCS/interface-changes.rst index e6e1eb317c..2c3cae76de 100644 --- a/DOCS/interface-changes.rst +++ b/DOCS/interface-changes.rst @@ -24,6 +24,14 @@ Interface changes :: + --- mpv 0.31.1 --- + - change behavior when using legacy option syntax with options that start + with two dashes (``--`` instead of a ``-``). Now, using the recommended + syntax is required for options starting with ``--``, which means an option + value must be strictly passed after a ``=``, instead of as separate + argument. For example, ``--log-file f.txt`` was previously accepted and + behaved like ``--log-file=f.txt``, but now causes an error. Use of legacy + syntax that is still supported now prints a deprecation warning. --- mpv 0.31.0 --- - add `--resume-playback-check-mtime` to check consistent mtime when restoring playback state. |