Write some more basic Futatabi docs.

[nageru-docs] / video.rst

diff --git a/video.rst b/video.rst
index 88cf383b4df59f30978c6d1dcc6651df37509614..ed565f8d746b6ff82bbf17527e391d39073c56ba 100644 (file)
--- a/video.rst
+++ b/video.rst
@@ -94,7 +94,18 @@ You can also change its rate, e.g. by::
 This will make it play at twice its usual speed. Your rate should not be
 negative nor exactly zero. You can set a rate to e.g. 1e-6 if you want to
 in practice stop the video; once you change it back to normal speed,
-the next frame will resume playing.
+the next frame will resume playing. Be aware that changing the rate may
+make the audio behave unpredictably; there are no attempts to do time
+stretching or change the pitch accordingly.
+
+Finally, if you want to forcibly abort the playing of a video,
+even one that is blocking on I/O, you can use (since Nageru 1.7.2)::
+
+  video:disconnect()
+
+This is particularly useful when dealing with network streams, as FFmpeg does not
+always properly detect if the connection has been lost. See :ref:`menus`
+for a way to expose such functionality to the operator.
 
 
 Integration with CasparCG