summaryrefslogtreecommitdiffstats
path: root/DOCS/man/en/options.rst
diff options
context:
space:
mode:
authorwm4 <wm4@nowhere>2012-12-11 01:04:13 +0100
committerwm4 <wm4@nowhere>2012-12-11 01:04:13 +0100
commitc6fbf91a89db31081e740e77bf7c965147d4dc06 (patch)
tree92f793b44dc9557909780482951761ff5ce50ca4 /DOCS/man/en/options.rst
parent3f949cf50b5067f2fa18b1a2bbdfdd62a0d0ffdd (diff)
downloadmpv-c6fbf91a89db31081e740e77bf7c965147d4dc06.tar.bz2
mpv-c6fbf91a89db31081e740e77bf7c965147d4dc06.tar.xz
manpage: mark HTTP related options as deprecated/broken
Commit c02f25 switched the "http://" protocol to use ffmpeg's HTTP implementation (stream_lavf.c), instead of the mplayer internal one (http.c). Unfortunately, it turns out that there are some network related options that are not respected by stream_lavf.c, and consequently do not work anymore for "http://" URLs. This might be fixed later. Mark them as deprecated for now, as it might take arbitrarily long until this is taken care of.
Diffstat (limited to 'DOCS/man/en/options.rst')
-rw-r--r--DOCS/man/en/options.rst20
1 files changed, 20 insertions, 0 deletions
diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst
index 1d8798f260..0aa1098925 100644
--- a/DOCS/man/en/options.rst
+++ b/DOCS/man/en/options.rst
@@ -451,11 +451,15 @@
(network only)
Support cookies when making HTTP requests. Disabled by default.
+ *WARNING*: works with the deprecated ``mp_http://`` protocol only.
+
--cookies-file=<filename>
(network only)
Read HTTP cookies from <filename>. The file is
assumed to be in Netscape format.
+ *WARNING*: works with the deprecated ``mp_http://`` protocol only.
+
--correct-pts, --no-correct-pts
Switches mpv to a mode where timestamps for video frames are
calculated differently and video filters which add new frames or modify
@@ -755,6 +759,8 @@
--http-header-fields=<field1,field2>
Set custom HTTP fields when accessing HTTP stream.
+ *WARNING*: works with the deprecated ``mp_http://`` protocol only.
+
*EXAMPLE*:
``mpv --http-header-fields='Field1: value1','Field2: value2' http://localhost:1234``
@@ -863,6 +869,8 @@
Skip any HTTP proxy for IPv6 addresses. It will still be used for IPv4
connections.
+ *WARNING*: works with the deprecated ``mp_http://`` protocol only.
+
--joystick, --no-joystick
Enable/disable joystick support. Enabled by default.
@@ -1351,6 +1359,8 @@
Used with some network protocols. Specify password for HTTP authentication.
See also ``--user``.
+ *WARNING*: works with the deprecated ``mp_http://`` protocol only.
+
--playing-msg=<string>
Print out a string before starting playback. The string is expanded for
properties, e.g. ``--playing-msg=file: \${filename}`` will print the string
@@ -1407,9 +1417,13 @@
--prefer-ipv4
Use IPv4 on network connections. Falls back on IPv6 automatically.
+ *WARNING*: works with the deprecated ``mp_http://`` protocol only.
+
--prefer-ipv6
Use IPv6 on network connections. Falls back on IPv4 automatically.
+ *WARNING*: works with the deprecated ``mp_http://`` protocol only.
+
--priority=<prio>
(Windows only.)
Set process priority for mpv according to the predefined priorities
@@ -1594,6 +1608,8 @@
--referrer=<string>
Specify a referrer path or URL for HTTP requests.
+ *WARNING*: works with the deprecated ``mp_http://`` protocol only.
+
--reuse-socket
(udp:// only)
Allows a socket to be reused by other processes as soon as it is closed.
@@ -2183,9 +2199,13 @@
Used with some network protocols.
Specify username for HTTP authentication. See also ``--passwd``.
+ *WARNING*: works with the deprecated ``mp_http://`` protocol only.
+
--user-agent=<string>
Use <string> as user agent for HTTP streaming.
+ *WARNING*: works with the deprecated ``mp_http://`` protocol only.
+
-v
Increment verbosity level, one level for each ``-v`` found on the command
line.