From ffc9aa81044fa4d906a3fccec8a37b7b2a99643f Mon Sep 17 00:00:00 2001 From: wm4 Date: Sat, 17 Sep 2016 19:08:35 +0200 Subject: manpage: document some more property/options inconsistencies --- DOCS/man/input.rst | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) (limited to 'DOCS') diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst index faf52fd4b1..cc81e6a125 100644 --- a/DOCS/man/input.rst +++ b/DOCS/man/input.rst @@ -2082,6 +2082,33 @@ caveats with some properties (due to historical reasons): If a VO is created, this will return either the actual display FPS, or an invalid value, instead of the option value. +``vf``, ``af`` + If you set the properties during playback, and the filter chain fails to + reinitialize, the new value will be rejected. Setting the option or + setting the property outside of playback will always succeed/fail in the + same way. Also, there are no ``vf-add`` etc. properties, but you can use + the ``vf``/``af`` group of commands to achieve the same. + +``chapter`` + While playback is *not* active, the property behaves like the option, and + you can set a chapter range. While playback is active, you can set only + the current chapter (to which the player will seek immediately). + +``volume`` + When set as option, the maximum (set by ``--volume-max``) is not checked, + while when set as property, the maximum is enforced. + +``playlist`` + The property is read-only and returns the current internal playlist. The + option is for loading playlist during command line parsing. For client API + uses, you should use the ``loadlist`` command instead. + +``playlist-pos`` + The property refuses setting out of range values, restarts playback + immediately when writing to it, and does not know the ``no`` value (which + the option uses to indicate the default state, that is resuming a file + on the playlist and jumping to that instead of entry 0). + ``audio-file``, ``sub-file``, ``external-file`` These options/properties are actually lists of filenames. To make the command-line interface easier, each ``--audio-file=...`` option appends -- cgit v1.2.3