diff options
author | wm4 <wm4@nowhere> | 2020-03-21 14:11:37 +0100 |
---|---|---|
committer | wm4 <wm4@nowhere> | 2020-03-21 19:32:50 +0100 |
commit | c892eff9299e364012eeae351ead3a40f1070ae1 (patch) | |
tree | 62b5aee925dfb1c9cd008e1c013885a42f79a10c | |
parent | 9815887435e7cbf86e1567d9bd4726dcaec21308 (diff) | |
download | mpv-c892eff9299e364012eeae351ead3a40f1070ae1.tar.bz2 mpv-c892eff9299e364012eeae351ead3a40f1070ae1.tar.xz |
manpage: improve loadfile description
-rw-r--r-- | DOCS/man/input.rst | 12 |
1 files changed, 9 insertions, 3 deletions
diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst index 7c7a6b3d44..a212224e78 100644 --- a/DOCS/man/input.rst +++ b/DOCS/man/input.rst @@ -378,7 +378,11 @@ Remember to quote string arguments in input.conf (see `Flat command syntax`_). Terminate playback if the first file is being played. ``loadfile <url> [<flags> [<options>]]`` - Load the given file or URL and play it. + Load the given file or URL and play it. Technically, this is just a playlist + manipulation command (which either replaces the playlist or appends an entry + to it). Actual file loading happens independently. For example, a + ``loadfile`` command that replaces the current file with a new one returns + before the current file is stopped, and the new file even begins loading. Second argument: @@ -393,8 +397,10 @@ Remember to quote string arguments in input.conf (see `Flat command syntax`_). The third argument is a list of options and values which should be set while the file is playing. It is of the form ``opt1=value1,opt2=value2,..``. - Not all options can be changed this way. Some options require a restart - of the player. + When using the client API, this can be a ``MPV_FORMAT_NODE_MAP`` (or a Lua + table), however the values themselves must be strings currently. These + options are set during playback, and restored to the previous value at end + of playback (see `Per-File Options`_). ``loadlist <url> [<flags>]`` Load the given playlist file or URL (like ``--playlist``). |