summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2013-06-23 02:31:51 +0200
committerwm4 <wm4@nowhere>2013-06-29 22:58:13 +0200
commit776e2893a23c9cd139c406e15c6ec56ebba48b01 (patch)
treea5bd236015ee5e5dfd61364d5186e3cc7e4a14bf
parent5b38a522f17aa24d89b807846c2f76760923351f (diff)
downloadmpv-776e2893a23c9cd139c406e15c6ec56ebba48b01.tar.bz2
mpv-776e2893a23c9cd139c406e15c6ec56ebba48b01.tar.xz
manpage: document input sections
-rw-r--r--DOCS/man/en/input.rst22
1 files changed, 21 insertions, 1 deletions
diff --git a/DOCS/man/en/input.rst b/DOCS/man/en/input.rst
index 440d1a655e..e904e0b86b 100644
--- a/DOCS/man/en/input.rst
+++ b/DOCS/man/en/input.rst
@@ -31,7 +31,7 @@ must kill **mpv** externally to make it exit.)
General input command syntax
----------------------------
-`[Shift+][Ctrl+][Alt+][Meta+]<key> [<prefixes>] <command> (<argument>)*`
+`[Shift+][Ctrl+][Alt+][Meta+]<key> [{<section>}] [<prefixes>] <command> (<argument>)*`
Newlines always start a new binding. ``#`` starts a comment (outside of quoted
string arguments). To bind commands to the ``#`` key, ``SHARP`` can be used.
@@ -39,6 +39,8 @@ string arguments). To bind commands to the ``#`` key, ``SHARP`` can be used.
<key> is either the literal character the key produces (ASCII or unicode
character), or a symbol name.
+<section> (braced with ``{`` and ``}``) is the input section for this command.
+
Arguments are separated by whitespace. This applies even to string arguments.
For this reason, string arguments should be quoted with ``"``. Inside quotes,
C style escaping can be used.
@@ -298,6 +300,24 @@ settings.
Undocumented prefixes: pausing, pausing_keep, pausing_toggle,
pausing_keep_force. (Should these be made official?)
+Input sections
+--------------
+
+Input sections group a set of bindings, and enable or disable them at once.
+In ``input.conf``, each key binding is assigned to an input section, rather
+than actually having explicit text sections.
+
+Also see ``enable_section`` and ``disable_section`` commands.
+
+Predefined bindings:
+
+default
+ Bindings without input section are implicitly assigned to this section. It
+ is enabled by default during normal playback.
+encode
+ Section which is active in encoding mode. It is enabled exclusively, so
+ that bindings in the ``default`` sections are ignored.
+
Properties
----------