Why I/O plugins are cheaper than busses

[ardour-manual] / include / toolbox.html

diff --git a/include/toolbox.html b/include/toolbox.html
index 7b2f65b5af44049d1d934c84d6a5365ad261740a..cc4d880015f3c64df55b2b431eef7fe51ec36f7d 100644 (file)
--- a/include/toolbox.html
+++ b/include/toolbox.html
@@ -21,7 +21,7 @@
 </table>
 
 <p>
-  Ripple Edit mode provides the following:
+  The general idea behind the Ripple edit mode is this:
   <ul>
     <li>Deleting a range will move later regions to compensate for the deleted time</li>
     <li>Deleting a region will move later regions to compensate for the deleted region's length</li>
@@ -30,6 +30,35 @@
   </ul>
 </p>
 
+<p>
+  Within this general behavior several variations are available
+  as Ripple edit modes:
+</p>
+
+<ol>
+  <li>
+    <dfn>Selected</dfn>. Only applies the ripple logic to currently selected
+    tracks. After making a selection, you can use the
+    <kbd class="button">Alt</kbd> modifier and click on tracks to add or remove
+    them to/from the selection. Markers will stay intact.
+  </li>
+  <li>
+    <dfn>All</dfn>. Applies the ripple logic to all tracks on the timeline
+    and shifts location, CD, and cue markers accordingly. Selecting a range
+    with this mode will automatically make a time-constrained selection in all tracks of the project.
+  </li>
+  <li>
+    <dfn>Interview</dfn>. This mode works just like the <dfn>Selected</dfn>
+    mode with one exception: when you select a range and press
+    <kbd class="button">Del</kbd>, this will remove the selected portion
+    of either audio or MIDI without shifting other clips to the left to match
+    the freed space on the timeline. The main use case for this mode is editing 
+    interviews where you want the ripple behavior to edit out e.g. periods
+    of silence, while being able to just delete e.g. an out-of-place
+    noise or an exclamation by the interviewer.
+  </li>
+</ol>
+
 <p class="note">
   If <kbd class="menu">Snap To Grid</kbd> is enabled, then regions can
   only move so that they align with locations determined by the current
@@ -128,7 +157,8 @@
   Resizing a region is done by <kbd class="mouse">left</kbd>-clicking on
   the right-hand side of the region and dragging the edge to the desired
   position; once the button is released a <kbd class="menu">Time Stretch
-  Audio</kbd> dialog will appear.
+  Audio</kbd> dialog will appear, as detailed in the dedicated <a href="@@stretching">
+  Stretching</a> page.
 </p>
 
 <h3 id="audition">Audition Mode</h3>