Update Insert docs for 7.1

[ardour-manual] / include / inserts.html

diff --git a/include/inserts.html b/include/inserts.html
index 10278f4e63e73e3dc3a6a3579c0e0d45fc98934f..ed8d20a7464ef3d40563b8d325253feff6cf8333 100644 (file)
--- a/include/inserts.html
+++ b/include/inserts.html
@@ -4,28 +4,55 @@
   inside a channel strip. Unlike Auxes, they will interrupt the signal flow,
   feeding the signal from before the insert point to its <dfn>Insert
   send(s)</dfn>, and connecting the remainder of the channel strip to the
-  <dfn>Insert return(s)</dfn>, both of which are JACK ports which are
-  visible to other JACK applications.<br>
-  Inserts are the JACK equivalents of normalized switching jacks on an 
-  analog console.
+  <dfn>Insert return(s)</dfn>, both of which are either audio device or JACK ports.
+</p>
+
+<p class="note">
+  When an insert is created, the signal will be interrupted until the relevant
+  connections to the insert ports are made!
+</p>
+
+<p>
+  While jack ports are visible to other JACK applications, ALSA ports are only
+  useful for patching in audio equipment external to the computer. If inserting
+  a software processor is required, a plugin would be the first choice. If a plugin
+  is not available then the jackd audio backend would have to be used. This is
+  not very common any more but there are some older jack clients that require
+  using jack.
+</p>
+<p>
+  Inserts work the same as the inserts on analog consoles except they are not
+  normalled like most jacks on an analog console.
 </p>
 <p>
-  An insert allows you to either use a special external DSP JACK 
+  An insert allows to either use a special external DSP JACK
   application that is not available as a plugin, or to splice an external
-  analog piece of gear into your channel strip, such as a vintage
-  compressor, tube equalizer, etc. In the latter case, you would first
-  connect your inserts to a pair of hardware ports, which are in turn
-  connected to the outboard gear.
+  analog piece of gear into a channel strip, such as a vintage
+  compressor, tube equalizer, etc. In the latter case, the inserts would first
+  be connected to a pair of hardware ports, which are in turn connected to the
+  outboard gear. This is done on the <kbd class="tab">Send/Output</kbd> and
+  <kbd class="tab">Return/Input</kbd> tabs of the <kbd class="window">Insert</kbd>
+  dialog respectively.
 </p>
+
+<figure>
+  <img src="/images/port-insert-send.png" width="50%" alt="Insert / Send">
+  <figcaption>
+    Insert Dialog, the Send/Output tab
+  </figcaption>
+</figure>
+
 <p>
-  To disable (bypass) an insert, click on its LED in the processor box.
+  Apart from providing access to the connections matrix, the dialog allows adjusting
+  the output gain and toggling phase inversion for Send/Output, as well as measuring
+  and adjusting latency for the insert.
 </p>
+
 <p class="note">
-  When you create an insert, the signal will be interrupted until you make
-  the relevant connections to the insert ports!
+  Inserts will incur an additional period of latency, which can be
+  measured and compensated for during mixing, but not during tracking!
 </p>
-<p class="note">
-  Inserts will incur an additional JACK period of latency, which can be
-  measured and compensated for during mixing, but not during tracking! 
-</p>    
 
+<p>
+  Disabling (bypassing) an insert is done by clicking on its LED in the processor box.
+</p>