diff options
| author | Avi Halachmi (:avih) <avihpit@yahoo.com> | 2021-07-28 11:09:30 +0300 |
|---|---|---|
| committer | avih <avih@users.noreply.github.com> | 2021-07-30 09:52:34 +0300 |
| commit | 73c9509720e59aec059e206506c0cf461d635c9f (patch) | |
| tree | 0239b0cf2dba44db8c8e2ac94d19c64077c98ad5 /DOCS | |
| parent | 3f0e8bd506e3e3fc6eb9927f0b2d04b23e9105a2 (diff) | |
| download | mpv-73c9509720e59aec059e206506c0cf461d635c9f.tar.bz2 mpv-73c9509720e59aec059e206506c0cf461d635c9f.tar.xz | |
input: argument custom quotes: use ` instead of !
Custom quotes were added in 4f129a3e and began with !, however, this
required quoting "!reverse" (used for the cycle-values command), which
is inconvenient, and was not taken into account when ! was chosen for
custom quotes. Also, ` is more natural for quoting than !.
This does break backward compatibility with the earlier form of custom
quotes, but at least we didn't make a release yet since custom quotes
were added (the last release - 0.33[.1] doesn't support it).
Diffstat (limited to 'DOCS')
| -rw-r--r-- | DOCS/man/input.rst | 10 |
1 files changed, 5 insertions, 5 deletions
diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst index b8eef24d24..12cb75afde 100644 --- a/DOCS/man/input.rst +++ b/DOCS/man/input.rst @@ -162,7 +162,7 @@ a number of other places. | | ``<command> ::= [<prefixes>] <command_name> (<argument>)*`` -| ``<argument> ::= (<unquoted> | " <double_quoted> " | !X <custom_quoted> X!)`` +| ``<argument> ::= (<unquoted> | " <double_quoted> " | `X <custom_quoted> X`)`` ``command_name`` is an unquoted string with the command name itself. See `List of Input Commands`_ for a list. @@ -171,10 +171,10 @@ Arguments are separated by whitespaces even if the command expects only one argument. Arguments with whitespaces or other special characters must be quoted, or the command cannot be parsed correctly. -Double quoted arguments start and end with ``"``. Custom quotes start with ``!`` -(exclamation mark) followed by any ASCII character, and end in the same pair in -reverse order, e.g. ``!'foo'!`` or ``!-bar-!``. The final pair sequence is not -allowed inside the string - in these examples ``'!`` and ``-!`` respectively. +Double quoted arguments start and end with ``"``. Custom quotes start with ````` +(back-quote) followed by any ASCII character, and end in the same pair in +reverse order, e.g. ```-foo-``` or ````bar````. The final pair sequence is not +allowed inside the string - in these examples ``-``` and `````` respectively. Custom quotes take their content literally, while inside double quotes JSON/C-style escaping can be used. JSON escapes according to RFC 8259, minus |