From c892eff9299e364012eeae351ead3a40f1070ae1 Mon Sep 17 00:00:00 2001 From: wm4 Date: Sat, 21 Mar 2020 14:11:37 +0100 Subject: manpage: improve loadfile description --- DOCS/man/input.rst | 12 +++++++++--- 1 file 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 [ []]`` - 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 []`` Load the given playlist file or URL (like ``--playlist``). -- cgit v1.2.3