core: add --stream-capture

This is a partial revert of commit 7059c15, and basically re-adds
--capture, just with different option names and slightly different
semantics.

2 files changed, 10 insertions, 0 deletions

diff --git a/DOCS/man/en/input.rst b/DOCS/man/en/input.rst
index 638172289c..5ae78ca06d 100644
--- a/DOCS/man/en/input.rst
+++ b/DOCS/man/en/input.rst
@@ -341,6 +341,7 @@ sub-scale                   x subtitle font size multiplicator
 ass-use-margins             x see ``--ass-use-margins``
 ass-vsfilter-aspect-compat  x see ``--ass-vsfilter-aspect-compat``
 ass-style-override          x see ``--ass-style-override``
+stream-capture              x a filename, see ``--capture``
 tv-brightness               x
 tv-contrast                 x
 tv-saturation               x
diff --git a/DOCS/man/en/options.rst b/DOCS/man/en/options.rst
index cd1b4ab90a..2f3e5bf38d 100644
--- a/DOCS/man/en/options.rst
+++ b/DOCS/man/en/options.rst
@@ -1528,6 +1528,15 @@
     Print out a custom string during playback instead of the standard status
     line. Expands properties. See ``--playing-msg``.
 
+--stream-capture=<filename>
+    Allows capturing the primary stream (not additional audio tracks or other
+    kind of streams) into the given file. Capturing can also be started and
+    stopped changing the filename with the ``stream-capture`` slave property.
+    Generally this will not produce usable results for anything else than MPEG
+    or raw streams, unless capturing includes the file headers and is not
+    interrupted. Note that, due to cache latencies, captured data may begin and
+    end somewhat delayed compared to what you see displayed.
+
 --playlist=<filename>
     Play files according to a playlist file (ASX, Winamp, SMIL, or
     one-file-per-line format).