diff options
author | wm4 <wm4@nowhere> | 2012-08-15 22:21:17 +0200 |
---|---|---|
committer | wm4 <wm4@nowhere> | 2012-08-15 23:59:45 +0200 |
commit | 0e7cf9518ae00e47f95762ead0c173fd6ac5f71d (patch) | |
tree | b64eb91ff0db3376e35de8a64032f7fed3f98b1b /DOCS | |
parent | 6879d1162c13a39cdfc231e7052711db0926d590 (diff) |
core: intentionally cripple slave mode
Rename -slave to -slave-broken to prevent slave mode applications from
working. Do this to prevent horrible user experiences, in case someone
should attempt to try this version of mplayer with smplayer and others.
This also makes it clear that we don't intend to keep slave mode
compatibility, because the slave mode protocol is horrible and bad.
See the changes in options.rst for further reasons and comments.
Diffstat (limited to 'DOCS')
-rw-r--r-- | DOCS/man/en/options.rst | 25 |
1 files changed, 15 insertions, 10 deletions
diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst index 4810ee9ea5..a842187137 100644 --- a/DOCS/man/en/options.rst +++ b/DOCS/man/en/options.rst @@ -1743,16 +1743,21 @@ - ``mplayer --slang=jpn example.mkv`` plays a Matroska file with Japanese subtitles. ---slave - Switches on slave mode, in which MPlayer works as a backend for other - programs. Instead of intercepting keyboard events, MPlayer will read - commands separated by a newline (\n) from stdin. See also ``--input``, - suboption ``file``. - - *NOTE*: See ``DOCS/tech/slave.txt`` for a description of slave commands. - Also, this is not intended to disable other inputs, e.g. via the video - window. If you want to do that, use something like - ``--input=nodefault-bindings:conf=/dev/null``. +--slave-broken + Switches on the old slave mode. This is for testing only, and incompatible + to the removed --slave switch. + + *NOTE*: Changes incompatible to slave mode applications have been made. In + particular, the status line output was changed, which is used by some + applications to determine the current playback position. This switch has + been renamed to prevent these applications from working with this version + of mplayer, because it would lead to buggy and confusing behavior only. + Moreover, the slave mode protocol is so horribly bad that it should not be + used for new programs, nor should existing programs attempt to adapt to the + changed output and use the --slave-broken switch. Instead, a new, saner + protocol should be developed (and will, if there is enough interest). + + This affects smplayer, smplayer2, mplayosx, and others. --slices, --no-slices Drawing video by 16-pixel height slices/bands, instead draws the |