summaryrefslogtreecommitdiffstats
path: root/DOCS
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2012-08-15 22:21:17 +0200
committerwm4 <wm4@nowhere>2012-08-15 23:59:45 +0200
commit0e7cf9518ae00e47f95762ead0c173fd6ac5f71d (patch)
treeb64eb91ff0db3376e35de8a64032f7fed3f98b1b /DOCS
parent6879d1162c13a39cdfc231e7052711db0926d590 (diff)
downloadmpv-0e7cf9518ae00e47f95762ead0c173fd6ac5f71d.tar.bz2
mpv-0e7cf9518ae00e47f95762ead0c173fd6ac5f71d.tar.xz
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.rst25
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