Add a subchapter on cue markers

[ardour-manual] / include / toolbox.html

diff --git a/include/toolbox.html b/include/toolbox.html
index e4bab1bf1469dfd7ae9f6f3d1b7b84f548bd7b15..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