options: add --script-opt alias for --script-opts-append

Kacper Michajłow committed 2 years ago

Commit 153d4921 parent 4045fac4 files · +10 −5Browse files

Unified · Split

4 files

@@ -0,0 +1 @@
		1	add `--script-opt` alias for `--script-opts-append`

     ``--scripts`` is a path list option. See `List Options`_ for details.
-``--script-opts=key1=value1,key2=value2,...``
+``--script-opt=<key=value>``, ``--script-opts=key1=value1,key2=value2,...``
     Set options for scripts. A script can query an option by key. If an
     option is used and what semantics the option value has depends entirely on
     the loaded scripts. Values not claimed by any scripts are ignored.
-    This is a key/value list option. See `List Options`_ for details.
+    Each use of the ``--script-opt`` option will add another option to the
+    internal list, while ``--script-opts`` takes a list of options at once,
+    and overwrites the internal list with it. The latter is a key/value list
+    option. See `List Options`_ for details.
 ``--merge-files``
     Pretend that all files passed to mpv are concatenated into a single, big

@@ -251,11 +251,11 @@ The keys are grouped automatically using a simple analysis of the command · 250 unmodified lines
251	string, and one should not expect documentation-level grouping accuracy,	251	string, and one should not expect documentation-level grouping accuracy,
252	however, it should still be reasonably useful.	252	however, it should still be reasonably useful.
253		253
254	Using ``--idle --script-opts-append=stats-bindlist=yes`` will print the list to	254	Using ``--idle --script-opt=stats-bindlist=yes`` will print the list to
255	the terminal and quit immediately. Long lines are clipped to the terminal width	255	the terminal and quit immediately. Long lines are clipped to the terminal width
256	unless this is disabled with ``--script-opts-append=stats-term_clip=no``. Escape	256	unless this is disabled with ``--script-opt=stats-term_clip=no``. Escape
257	sequences can be disabled by adding ``-`` before ``yes``, i.e.	257	sequences can be disabled by adding ``-`` before ``yes``, i.e.
258	``--script-opts-append=stats-bindlist=-yes``.	258	``--script-opt=stats-bindlist=-yes``.
259		259
260	Like with ``--input-test``, the list includes bindings from ``input.conf`` and	260	Like with ``--input-test``, the list includes bindings from ``input.conf`` and
261	from user scripts. Use ``--no-config`` to list only built-in bindings.	261	from user scripts. Use ``--no-config`` to list only built-in bindings.

@@ -557,6 +557,7 @@ static const m_option_t mp_opts[] = { · 556 unmodified lines
557	{"scripts", OPT_PATHLIST(script_files), .flags = M_OPT_FILE},	557	{"scripts", OPT_PATHLIST(script_files), .flags = M_OPT_FILE},
558	{"script", OPT_CLI_ALIAS("scripts-append")},	558	{"script", OPT_CLI_ALIAS("scripts-append")},
559	{"script-opts", OPT_KEYVALUELIST(script_opts)},	559	{"script-opts", OPT_KEYVALUELIST(script_opts)},
		560	{"script-opt", OPT_CLI_ALIAS("script-opts-append")},
560	{"load-scripts", OPT_BOOL(auto_load_scripts)},	561	{"load-scripts", OPT_BOOL(auto_load_scripts)},
561	#endif	562	#endif
562	#if HAVE_JAVASCRIPT	563	#if HAVE_JAVASCRIPT

Keyboard shortcuts