Document pause frames.

[nageru-docs] / futatabi.rst

diff --git a/futatabi.rst b/futatabi.rst
index 75d947a87fa5d4b35837904b5ac8ec1788c9d4f4..cb7c0dba5e69996e3e6b80fce764932d6eef1107 100644 (file)
--- a/futatabi.rst
+++ b/futatabi.rst
@@ -56,7 +56,7 @@ input or output. Assuming you have a recent version of Nageru (typically one
 that comes with Futatabi), it is capable of sending all of its cameras as one
 video stream (see :ref:`futatabiformat`), so you can start Futatabi with
 
-  ./futatabi http://path.to.nageru.host/multicam.mp4
+  ./futatabi http://nageru-server.example.org/multicam.mp4
 
 If you do not have a running Nageru installation, see :ref:`sampledata`.
 
@@ -74,7 +74,9 @@ directory (you can change it with the -d option). This holds all of the
 recorded frames, all metadata about clips, and preferences set from the menus
 (interpolation quality and cue point padding).  If you quit Futatabi and
 restart it (or you go down as the result of a power failure or the likes),
-it will remember all the state and frames for you.
+it will remember all the state and frames for you. As a special case,
+if you give */dev/null* in place of an input URL or file, you can keep using
+your workspace without getting any new frames added.
 
 .. _basicui:
 
@@ -263,6 +265,11 @@ from frame to frame; this is because for original (uninterpolated) frames,
 Futatabi will simply output the received JPEG frame directly to the output
 stream, which can be a different resolution from the interpolated frames.
 
+Also, even though Futatabi exists to make a fixed-framerate stream out of
+something that's not, the output stream can be variable-framerate (VFR) due to
+pauses and frame drops. In particular, when the stream is paused, frames are
+only output about every 100 milliseconds.
+
 Finally, the subtitle track with status information (see :ref:`talkback`) is
 not marked as metadata due to FFmpeg limitations, and as such will show up
 raw in subtitle-enabled players.