From 32c63fc1192b6ef0b57ba2552630f572b84968fd Mon Sep 17 00:00:00 2001 From: Martin Herkt Date: Thu, 24 Apr 2014 17:27:27 +0200 Subject: options: rename input-related options MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --ar → --input-appleremote --consolecontrols → --input-terminal --media-keys → --input-media-keys --joystick → --input-joystick --lirc → --input-lirc --lircconf → --input-lirc-conf --mouse-movements → --input-cursor --right-alt-gr → --input-right-alt-gr --- DOCS/man/en/changes.rst | 5 +++ DOCS/man/en/input.rst | 2 +- DOCS/man/en/options.rst | 100 ++++++++++++++++++++++++------------------------ 3 files changed, 56 insertions(+), 51 deletions(-) (limited to 'DOCS/man/en') diff --git a/DOCS/man/en/changes.rst b/DOCS/man/en/changes.rst index 860b5194da..af890a4178 100644 --- a/DOCS/man/en/changes.rst +++ b/DOCS/man/en/changes.rst @@ -161,9 +161,14 @@ Command Line Switches ``-hardframedrop`` ``--framedrop=hard`` ``-lavdopts ...`` ``--vd-lavc-...`` ``-lavfdopts`` ``--demuxer-lavf-...`` + ``-lircconf`` ``--input-lirc-conf`` ``-loop 0`` ``--loop=inf`` ``-mixer-channel`` AO suboptions (``alsa``, ``oss``) ``-mixer`` AO suboptions (``alsa``, ``oss``) + ``-mouse-movements`` ``--input-cursor`` + ``-noar`` ``--no-input-appleremote`` + ``-noconsolecontrols`` ``--no-input-terminal`` + ``-nojoystick`` ``--no-input-joystick`` ``-nosound`` ``--no-audio`` ``-osdlevel`` ``--osd-level`` ``-panscanrange`` ``--video-zoom``, ``--video-pan-x/y`` diff --git a/DOCS/man/en/input.rst b/DOCS/man/en/input.rst index 52ba8168f3..cb2361f27e 100644 --- a/DOCS/man/en/input.rst +++ b/DOCS/man/en/input.rst @@ -33,7 +33,7 @@ General Input Command Syntax Note that by default, the right Alt key can be used to create special characters, and thus does not register as a modifier. The option -``--no-right-alt-gr`` changes this behavior. +``--no-input-right-alt-gr`` changes this behavior. Newlines always start a new binding. ``#`` starts a comment (outside of quoted string arguments). To bind commands to the ``#`` key, ``SHARP`` can be used. diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst index ecb5dc4dc1..968cf014d9 100644 --- a/DOCS/man/en/options.rst +++ b/DOCS/man/en/options.rst @@ -97,9 +97,6 @@ OPTIONS configuration files specifying a list of fallbacks may make sense. See `AUDIO OUTPUT DRIVERS`_ for details and descriptions of available drivers. -``--ar``, ``--no-ar`` - Enable/disable AppleIR remote support. Enabled by default. - ``--aspect=`` Override movie aspect ratio, in case aspect information is incorrect or missing in the file being played. See also ``--no-aspect``. @@ -575,15 +572,6 @@ OPTIONS Note that the ``--no-config`` option takes precedence over this option. -``--consolecontrols``, ``--no-consolecontrols`` - ``--no-consolecontrols`` prevents the player from reading key events from - standard input. Useful when reading data from standard input. This is - automatically enabled when ``-`` is found on the command line. There are - situations where you have to set it manually, e.g. if you open - ``/dev/stdin`` (or the equivalent on your system), use stdin in a playlist - or intend to read from stdin later on via the loadfile or loadlist slave - commands. - ``--contrast=<-100-100>`` Adjust the contrast of the video signal (default: 0). Not supported by all video output drivers. @@ -1225,23 +1213,21 @@ OPTIONS Specify input configuration file other than the default ``~/.mpv/input.conf``. -``--input-ar-delay`` - Delay in milliseconds before we start to autorepeat a key (0 to disable). - -``--input-ar-rate`` - Number of key presses to generate per second on autorepeat. - ``--no-input-default-bindings`` Disable mpv default (builtin) key bindings. -``--input-keylist`` - Prints all keys that can be bound to commands. - ``--input-cmdlist`` Prints all commands that can be bound to keys. -``--input-js-dev`` - Specifies the joystick device to use (default: ``/dev/input/js0``). +``--input-keylist`` + Prints all keys that can be bound to commands. + +``--input-test`` + Input test mode. Instead of executing commands on key presses, mpv + will show the keys and the bound commands on the OSD. Has to be used + with a dummy video, and the normal ways to quit the player will not + work (key bindings that normally quit will be shown on OSD only, just + like any other binding). See `INPUT.CONF`_. ``--input-file=`` Read commands from the given file. Mostly useful with a FIFO. @@ -1252,16 +1238,50 @@ OPTIONS When the given file is a FIFO mpv opens both ends, so you can do several `echo "seek 10" > mp_pipe` and the pipe will stay valid. -``--input-test`` - Input test mode. Instead of executing commands on key presses, mpv - will show the keys and the bound commands on the OSD. Has to be used - with a dummy video, and the normal ways to quit the player will not - work (key bindings that normally quit will be shown on OSD only, just - like any other binding). See `INPUT.CONF`_. +``--input-terminal``, ``--no-input-terminal`` + ``--no-input-terminal`` prevents the player from reading key events from + standard input. Useful when reading data from standard input. This is + automatically enabled when ``-`` is found on the command line. There are + situations where you have to set it manually, e.g. if you open + ``/dev/stdin`` (or the equivalent on your system), use stdin in a playlist + or intend to read from stdin later on via the loadfile or loadlist slave + commands. + +``--input-appleremote``, ``--no-input-appleremote`` + Enable/disable AppleIR remote support. Enabled by default. + +``--input-ar-delay`` + Delay in milliseconds before we start to autorepeat a key (0 to disable). + +``--input-ar-rate`` + Number of key presses to generate per second on autorepeat. + +``--input-cursor``, ``--no-input-cursor`` + Permit mpv to receive pointer events reported by the video output + driver. Necessary to select the buttons in DVD menus. Supported for + X11-based VOs (x11, xv, etc) and the gl, direct3d and corevideo VOs. -``--joystick``, ``--no-joystick`` +``--input-joystick``, ``--no-input-joystick`` Enable/disable joystick support. Disabled by default. +``--input-js-dev`` + Specifies the joystick device to use (default: ``/dev/input/js0``). + +``--input-lirc``, ``--no-input-lirc`` + Enable/disable LIRC support. Enabled by default. + +``--input-lirc-conf=`` + (LIRC only) + Specifies a configuration file for LIRC (default: ``~/.lircrc``). + +``--input-media-keys``, ``--no-input-media-keys`` + OSX only: Enabled by default. Enables/disable media keys support. + +``--input-right-alt-gr``, ``--no-input-right-alt-gr`` + (Cocoa and Windows only) + Use the right Alt key as Alt Gr to produce special characters. If disabled, + count the right Alt as an Alt modifier key. Enabled by default. + ``--no-keepaspect``, ``--keepaspect`` ``--no-keepaspect`` will always stretch the video to window size, and will disable the window manager hints that force the window aspect ratio. @@ -1292,13 +1312,6 @@ OPTIONS Stop after a given time relative to the start time. See ``--start`` for valid option values and examples. -``--lirc``, ``--no-lirc`` - Enable/disable LIRC support. Enabled by default. - -``--lircconf=`` - (LIRC only) - Specifies a configuration file for LIRC (default: ``~/.lircrc``). - ``--list-options`` Prints all available options. @@ -1349,9 +1362,6 @@ OPTIONS ``--mc=`` Maximum A-V sync correction per frame (in seconds) -``--media-keys``, ``--no-media-keys`` - OSX only: Enabled by default. Enables/disable media keys support. - ``--merge-files`` Pretend that all files passed to mpv are concatenated into a single, big file. This uses timeline/EDL support internally. Note that this won't work @@ -1386,11 +1396,6 @@ OPTIONS 1). A value of 1 means square pixels (correct for (almost?) all LCDs). See also ``--monitoraspect`` and ``--aspect``. -``--mouse-movements``, ``--no-mouse-movements`` - Permit mpv to receive pointer events reported by the video output - driver. Necessary to select the buttons in DVD menus. Supported for - X11-based VOs (x11, xv, etc) and the gl, direct3d and corevideo VOs. - ``--no-msgcolor`` Disable colorful console output on terminals. @@ -1876,11 +1881,6 @@ OPTIONS - ``--reset-on-next-file=all`` Try to reset all settings that were changed during playback. -``--right-alt-gr``, ``--no-right-alt-gr`` - (Cocoa and Windows only) - Use the right Alt key as Alt Gr to produce special characters. If disabled, - count the right Alt as an Alt modifier key. Enabled by default. - ``--rtsp-transport=`` Select RTSP transport method (default: tcp). This selects the underlying network transport when playing ``rtsp://...`` URLs. The value ``lavf`` -- cgit v1.2.3