X-Git-Url: https://git.sesse.net/?a=blobdiff_plain;f=gettingstarted.rst;h=469c5b04211bd8058fd04da7ecad9d76dc7b4777;hb=f2fb154081bf8d73aa8b750132fb17ba0fda12a9;hp=82b44577a263d1ab130e33ad5459e05f84b6927b;hpb=f9b943358dae95111268ede9c793f78683ac8827;p=nageru-docs

diff --git a/gettingstarted.rst b/gettingstarted.rst
index 82b4457..469c5b0 100644
--- a/gettingstarted.rst
+++ b/gettingstarted.rst
@@ -3,7 +3,7 @@ Getting started
 
 Welcome to Nageru! For simple use, you can jump right in and make yourself
 comfortable (at least if you have the :doc:`hardware requirements <hardware>`
-in place and have `compiled it <compile>`), but if you prefer a gentler introduction,
+in place and have `compiled it <compile>`_), but if you prefer a gentler introduction,
 this is the place.
 
 
@@ -44,6 +44,14 @@ preview (using the 1–9 keys) and the right hand to choose a transition
 (using J, K or L). In addition, audio can be controlled using a MIDI controller
 if you want to; see the :doc:`audio <audio>` page for more information.
 
+In some situations, like if you're producing sports, it can be useful to
+skip the preview step and cut directly to a source. Nageru supports this
+through **quick-cut keys**; if enabled, Q, W, E, etc. will have the same
+effect as pressing 1, 2, 3, etc. and then quickly J (for cut). Since it
+is easy to press such a key by mistake, this behavior is off by default,
+and must be enabled explicitly from the Video menu or through the
+“--quick-cut-keys” option.
+
 
 Channels
 ''''''''
@@ -74,6 +82,10 @@ see it if you look closely; it's a somewhat lighter shade of green),
 it will be marked with green. On conflict, red (live) wins, since it is
 the most important piece of information.
 
+If you have many channels, the default single-row view can make for previews
+that are somewhat small. If so, you can switch to the *video grid display*;
+see :ref:`audio-views` for more information.
+
 
 Transitions
 '''''''''''
@@ -123,8 +135,15 @@ The video menu contains the following elements:
     You can achieve the same effect as this option by sending
     SIGHUP to the Nageru process.
 
+  * **Open frame analyzer:** See :doc:`analyzer` for more information.
+
   * **Change x264 bitrate:** See :doc:`streaming` for more information.
 
+  * **HDMI/SDI output device, HDMI/SDI output resolution, Display time code:**
+    See :doc:`hdmisdi` for more information.
+
+  * **Enable quick-cut keys:** See above.
+
   * **Exit:** Exits Nageru, obviously.
 
 The audio menu is explained in the section on :doc:`audio <audio>`.
@@ -169,6 +188,16 @@ The options presented are as follows:
    cards that can handle it in hardware), but a simple option (“Scan”)
    is available to try all modes in turn until a signal is received.
 
+ * **Input interpretation:** Choose how the Y'CbCr values in the input signal
+   are to be interpreted. *Auto* will choose whatever is correct (as per the
+   appropriate standards) for the current video mode, but occasionally,
+   devices will get this wrong, and you will need to change this setting
+   to get correct colors. You can use the *--input-ycbcr-interpretation=*
+   command-line option to achieve the same effect.
+
+   See :doc:`analyzer` for figuring out if you need to change this.
+   If unsure, leave it unchanged.
+
  * **Use as audio source:** See the :doc:`audio <audio>` page for more
    information. For simple audio only; unavailable in multichannel mode.