Skip to content

Commit 9465b30

Browse files
guidocellaDudemanguy
authored andcommitted
DOCS: remove behavior changes before version 0.38
These are ancient and not useful anymore. The version notices are kept under: overlay-add: handled by #17520 end-file's file_error: the notice should be removed when updating error field like suggested there time-start: this should just be removed ~/.mpv/: needed to understand why this is used --aid: needed to understand the following paragraphs
1 parent 2e83b3b commit 9465b30

9 files changed

Lines changed: 65 additions & 125 deletions

File tree

DOCS/edl-mpv.rst

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -366,8 +366,7 @@ tracks. In this case, it's not obvious, which virtual tracks the EDL show should
366366
expose when being played.
367367

368368
Currently, mpv will apply an arbitrary heuristic which tracks the EDL file
369-
should expose. (Before mpv 0.30.0, it always used the first source file in the
370-
segment list.)
369+
should expose.
371370

372371
You can set the ``layout`` option to ``this`` to make a specific entry define
373372
the track layout.

DOCS/encoding.rst

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -42,9 +42,7 @@ section::
4242
oacopts-add = b=96k
4343

4444
It's also possible to define default encoding options by putting them into
45-
the section named ``[encoding]``. (This behavior changed after mpv 0.3.x. In
46-
mpv 0.3.x, config options in the default section / no section were applied
47-
to encoding. This is not the case anymore.)
45+
the section named ``[encoding]``.
4846

4947
One can then encode using this profile using the command::
5048

DOCS/man/input.rst

Lines changed: 17 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -322,10 +322,6 @@ Playback Control
322322
and ``absolute-percent`` seeks, while ``exact`` is used for ``absolute``
323323
seeks.
324324

325-
Before mpv 0.9, the ``keyframes`` and ``exact`` flags had to be passed as
326-
3rd parameter (essentially using a space instead of ``+``). The 3rd
327-
parameter is still parsed, but is considered deprecated.
328-
329325
This is a scalable command. See the documentation of ``nonscalable`` input
330326
command prefix in `Input Command Prefixes`_ for details.
331327

@@ -940,7 +936,7 @@ OSD Commands
940936
by passing a memory address as integer prefixed with an ``&`` character.
941937
Passing the wrong thing here will crash the player. This mode might be
942938
useful for use with libmpv. The ``offset`` parameter is simply added to the
943-
memory address (since mpv 0.8.0, ignored before).
939+
memory address.
944940

945941
``offset`` is the byte offset of the first pixel in the source file.
946942

@@ -1212,10 +1208,11 @@ Execution Commands
12121208
~~~~~~~~~~~~~~~~~~
12131209

12141210
``run <command> [<arg1> [<arg2> [...]]]``
1215-
Run the given command. Unlike in MPlayer/mplayer2 and earlier versions of
1216-
mpv (0.2.x and older), this doesn't call the shell. Instead, the command
1217-
is run directly, with each argument passed separately. Each argument is
1218-
expanded like in `Property Expansion`_.
1211+
Run the given command.
1212+
1213+
This doesn't call the shell. Instead, the command is run directly, with each
1214+
argument passed separately. Each argument is expanded like in `Property
1215+
Expansion`_.
12191216

12201217
This command has a variable number of arguments, and cannot be used with
12211218
named arguments.
@@ -1300,8 +1297,6 @@ Execution Commands
13001297

13011298
``passthrough_stdin`` (``MPV_FORMAT_FLAG``)
13021299
If enabled, wire the new process' stdin to mpv's stdin (default: no).
1303-
Before mpv 0.33.0, this argument did not exist, but the behavior was as
1304-
if this was set to true.
13051300

13061301
The command returns the following result (as ``MPV_FORMAT_NODE_MAP``):
13071302

@@ -1420,7 +1415,7 @@ Scripting Commands
14201415
1. The string ``key-binding``.
14211416
2. The name of the binding (as established above).
14221417
3. The key state as string (see below).
1423-
4. The key name (since mpv 0.15.0).
1418+
4. The key name.
14241419
5. The text the key would produce, or empty string if not applicable.
14251420
6. The scale of the key, such as the ones produced by ``WHEEL_*`` keys.
14261421
The scale is 1 if the key is nonscalable.
@@ -1502,7 +1497,7 @@ Screenshot Commands
15021497
If you combine this command with another one using ``;``, you can use the
15031498
``async`` flag to make encoding/writing the image file asynchronous. For
15041499
normal standalone commands, this is always asynchronous, and the flag has
1505-
no effect. (This behavior changed with mpv 0.29.0.)
1500+
no effect.
15061501

15071502
On success, returns a ``mpv_node`` with a ``filename`` field set to the
15081503
saved screenshot location.
@@ -2078,8 +2073,7 @@ prefixes can be specified. They are separated by whitespace.
20782073
``repeatable``
20792074
For some commands, keeping a key pressed doesn't run the command repeatedly.
20802075
This prefix forces enabling key repeat in any case. For a list of commands:
2081-
the first command determines the repeatability of the whole list (up to and
2082-
including version 0.33 - a list was always repeatable).
2076+
the first command determines the repeatability of the whole list.
20832077
``nonrepeatable``
20842078
For some commands, keeping a key pressed runs the command repeatedly.
20852079
This prefix forces disabling key repeat in any case.
@@ -2133,10 +2127,6 @@ command behaves by itself. There are the following cases:
21332127
have an asynchronous implementation. The async libmpv API still never blocks
21342128
the caller in these cases.
21352129

2136-
Before mpv 0.29.0, the ``async`` prefix was only used by screenshot commands,
2137-
and made them run the file saving code in a detached manner. This is the
2138-
default now, and ``async`` changes behavior only in the ways mentioned above.
2139-
21402130
Currently the following commands have different waiting characteristics with
21412131
sync vs. async: sub-add, audio-add, sub-reload, audio-reload,
21422132
rescan-external-files, screenshot, screenshot-to-file, dump-cache,
@@ -2292,9 +2282,6 @@ Property list
22922282
property is unavailable. Note that the file duration is not always exactly
22932283
known, so this is an estimate.
22942284

2295-
This replaces the ``length`` property, which was deprecated after the
2296-
mpv 0.9 release. (The semantics are the same.)
2297-
22982285
This has a sub-property:
22992286

23002287
``duration/full``
@@ -2425,11 +2412,9 @@ Property list
24252412

24262413
For Matroska files, this is the edition. For DVD/Blu-ray, this is the title.
24272414

2428-
Before mpv 0.31.0, this showed the actual edition selected at runtime, if
2429-
you didn't set the option or property manually. With mpv 0.31.0 and later,
2430-
this strictly returns the user-set option or property value, and the
2431-
``current-edition`` property was added to return the runtime selected
2432-
edition (this matters with ``--edition=auto``, the default).
2415+
This strictly returns the user-set option or property value, and the
2416+
``current-edition`` property returns the runtime selected edition (this
2417+
matters with ``--edition=auto``, the default).
24332418

24342419
``current-edition``
24352420
Currently selected edition. This property is unavailable if no file is
@@ -2562,7 +2547,7 @@ Property list
25622547

25632548
This also returns ``yes``/true if playback is restarting or if nothing is
25642549
playing at all. In other words, it's only ``no``/false if there's actually
2565-
video playing. (Behavior since mpv 0.7.0.)
2550+
video playing.
25662551

25672552
``cache-speed``
25682553
Current I/O read speed between the cache and the lower layer (like network).
@@ -2707,8 +2692,7 @@ Property list
27072692
``mixer-active``
27082693
Whether the audio mixer is active.
27092694

2710-
This option is relatively useless. Before mpv 0.18.1, it could be used to
2711-
infer behavior of the ``volume`` property.
2695+
This option is relatively useless.
27122696

27132697
``ao-volume`` (RW)
27142698
System volume. This property is available only if mpv audio output is
@@ -2781,9 +2765,8 @@ Property list
27812765
seek to refresh the video properly.) You can watch the other hwdec
27822766
properties to see whether this was successful.
27832767

2784-
Unlike in mpv 0.9.x and before, this does not return the currently active
2785-
hardware decoder. Since mpv 0.18.0, ``hwdec-current`` is available for
2786-
this purpose.
2768+
This does not return the currently active hardware decoder.
2769+
``hwdec-current`` is available for this purpose.
27872770

27882771
``hwdec-current``
27892772
The current hardware decoding in use. If decoding is active, return one of
@@ -3306,8 +3289,6 @@ Property list
33063289
"current", this property returns -1. Likewise, writing -1 will put the
33073290
player into idle mode (or exit playback if idle mode is not enabled). If an
33083291
out of range index is written to the property, this behaves as if writing -1.
3309-
(Before mpv 0.33.0, instead of returning -1, this property was unavailable
3310-
if no playlist entry was current.)
33113292

33123293
Writing the current value back to the property will have no effect.
33133294
Use ``playlist-play-index`` to restart the playback of the current entry if
@@ -3404,7 +3385,7 @@ Property list
34043385
MPV_FORMAT_NODE_ARRAY
34053386
MPV_FORMAT_NODE_MAP (for each playlist entry)
34063387
"filename" MPV_FORMAT_STRING
3407-
"current" MPV_FORMAT_FLAG (might be missing; since mpv 0.7.0)
3388+
"current" MPV_FORMAT_FLAG (might be missing)
34083389
"playing" MPV_FORMAT_FLAG (same)
34093390
"title" MPV_FORMAT_STRING (optional)
34103391
"id" MPV_FORMAT_INT64
@@ -4332,8 +4313,6 @@ caveats with some properties (due to historical reasons):
43324313
example, if you set ``aid=5``, and the currently played file contains no
43334314
audio track with ID 5, the ``aid`` property will return ``no``.
43344315

4335-
Before mpv 0.31.0, you could set existing tracks at runtime only.
4336-
43374316
``display-fps``
43384317
This inconsistent behavior is deprecated. Post-deprecation, the reported
43394318
value and the option value are cleanly separated (``override-display-fps``
@@ -4345,10 +4324,6 @@ caveats with some properties (due to historical reasons):
43454324
change. On the other hand, the next video to be played will fail, because
43464325
the initial filter chain cannot be created.
43474326

4348-
This behavior changed in mpv 0.31.0. Before this, the new value was rejected
4349-
*iff* a video (for ``vf``) or an audio (for ``af``) track was active. If
4350-
playback was not active, the behavior was the same as the current one.
4351-
43524327
``playlist``
43534328
The property is read-only and returns the current internal playlist. The
43544329
option is for loading playlist during command line parsing. For client API

DOCS/man/javascript.rst

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -350,8 +350,6 @@ paths - like ``<script-dir>/modules`` for scripts which load from a directory).
350350

351351
The custom-init file is ignored if mpv is invoked with ``--no-config``.
352352

353-
Before mpv 0.34, the file name was ``.init.js`` (with dot) at the same dir.
354-
355353
The event loop
356354
--------------
357355

DOCS/man/lua.rst

Lines changed: 8 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -61,8 +61,7 @@ that uses the ``.foo`` file extension.
6161
mpv also appends the top level directory of the script to the start of Lua's
6262
package path so you can import scripts from there too. Be aware that this will
6363
shadow Lua libraries that use the same package path. (Single file scripts do not
64-
include mpv specific directories in the Lua package path. This was silently
65-
changed in mpv 0.32.0.)
64+
include mpv specific directories in the Lua package path.)
6665

6766
Using a script directory is the recommended way to package a script that
6867
consists of multiple source files, or requires other files (you can use
@@ -100,17 +99,14 @@ The event loop will wait for events and dispatch events registered with
10099
``mp.register_event``. It will also handle timers added with ``mp.add_timeout``
101100
and similar (by waiting with a timeout).
102101

103-
Since mpv 0.6.0, the player will wait until the script is fully loaded before
104-
continuing normal operation. The player considers a script as fully loaded as
105-
soon as it starts waiting for mpv events (or it exits). In practice this means
106-
the player will more or less hang until the script returns from the main chunk
107-
(and ``mp_event_loop`` is called), or the script calls ``mp_event_loop`` or
102+
The player will wait until the script is fully loaded before continuing normal
103+
operation. The player considers a script as fully loaded as soon as it starts
104+
waiting for mpv events (or it exits). In practice this means the player will
105+
more or less hang until the script returns from the main chunk (and
106+
``mp_event_loop`` is called), or the script calls ``mp_event_loop`` or
108107
``mp.dispatch_events`` directly. This is done to make it possible for a script
109-
to fully setup event handlers etc. before playback actually starts. In older
110-
mpv versions, this happened asynchronously. With mpv 0.29.0, this changes
111-
slightly, and it merely waits for scripts to be loaded in this manner before
112-
starting playback as part of the player initialization phase. Scripts run though
113-
initialization in parallel. This might change again.
108+
to fully setup event handlers etc. before playback actually starts. Scripts run
109+
though initialization in parallel.
114110

115111
mp functions
116112
------------

DOCS/man/mpv.rst

Lines changed: 7 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -440,12 +440,10 @@ because ``--fs`` is a flag option that requires no parameter. If an option
440440
changes and its parameter becomes optional, then a command line using the
441441
alternative syntax will break.
442442

443-
Until mpv 0.31.0, there was no difference whether an option started with ``--``
444-
or a single ``-``. Newer mpv releases strictly expect that you pass the option
445-
value after a ``=``. For example, before ``mpv --log-file f.txt`` would write
446-
a log to ``f.txt``, but now this command line fails, as ``--log-file`` expects
447-
an option value, and ``f.txt`` is simply considered a normal file to be played
448-
(as in ``mpv f.txt``).
443+
For options starting with ``--``, mpv expects that you pass the option value
444+
after a ``=``. For example, ``mpv --log-file f.txt`` will fail, as
445+
``--log-file`` expects an option value, and ``f.txt`` is simply considered a
446+
normal file to be played (as in ``mpv f.txt``).
449447

450448
The future plan is that ``-option value`` will not work anymore, and options
451449
with a single ``-`` behave the same as ``--`` options.
@@ -484,9 +482,9 @@ quotes.
484482

485483
The ``[...]`` form of quotes wraps everything between ``[`` and ``]``. It's
486484
useful with shells that don't interpret these characters in the middle of
487-
an argument (like bash). These quotes are balanced (since mpv 0.9.0): the ``[``
488-
and ``]`` nest, and the quote terminates on the last ``]`` that has no matching
489-
``[`` within the string. (For example, ``[a[b]c]`` results in ``a[b]c``.)
485+
an argument (like bash). These quotes are balanced: the ``[`` and ``]`` nest,
486+
and the quote terminates on the last ``]`` that has no matching ``[`` within the
487+
string. (For example, ``[a[b]c]`` results in ``a[b]c``.)
490488

491489
The fixed-length quoting syntax is intended for use with external
492490
scripts and programs.
@@ -703,8 +701,6 @@ recommended to use the ``-append`` variant. When using libmpv, prefer using
703701
``MPV_FORMAT_NODE_MAP``; when using a scripting backend or the JSON IPC, use an
704702
appropriate structured data type.
705703

706-
Prior to mpv 0.33, ``:`` was also recognized as separator by ``-set``.
707-
708704
Object settings list options
709705
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
710706

0 commit comments

Comments
 (0)