A tiny addendum to the bbt markers doc

[ardour-manual] / include / trimming-regions.html

diff --git a/include/trimming-regions.html b/include/trimming-regions.html
index b2c101c60eca8a5c83dcedd0c28d16d35e88a939..e7e9eb908bd515ea8e642ace50eaa15e975d41a0 100644 (file)
--- a/include/trimming-regions.html
+++ b/include/trimming-regions.html
@@ -7,68 +7,50 @@
 </p>
 
 <h2>Drag-Trimming With the Mouse</h2>
 </p>
 
 <h2>Drag-Trimming With the Mouse</h2>

+
+<figure class="right">
+  <img src="/images/trimming-region-before.png" alt="Trimming region - before">
+  <img src="/images/trimming-region-after.png" alt="Trimming region - after">
+  <figcaption>
+    Trimming region - before and after
+  </figcaption>
+</figure>
+

 <p>
 <p>

-  In object mode, move the pointer near the beginning or end of the region.
-  The cursor will change to indicate that trimming is possible, and you then
-  <kbd class="mouse">Left</kbd>-drag the edge of the region.
-</p>
-<p>
-  Trimming will obey <a href="/ardours-interface/the-grid-controls/">Snap settings</a>.
+  In Grab mode, moving the pointer near the beginning or end of the region changes
+  the cursor to indicate that trimming is possible, and the edge of the region can
+  then be <kbd class="mouse">Left</kbd>-dragged in both directions.

 </p>
 </p>

-
-<h2>Click Trimming With the Mouse</h2>

 <p>
 <p>

-  <kbd class="mouse">Left</kbd>-click in the colored bar at the bottom of a region.
-  If you are nearer to the start of a region, this will trim the start time to the
-  position of the pointer. If you are nearer to the end of a region, it will trim the
-  end time.
+  Trimming will obey <a href="@@grid-controls">Snap settings</a>.

 </p>
 
 </p>
 

-<h2>Keyboard Shortcuts for Trimming</h2>
+<h2>Other Trimming operations</h2>

 <p>
   There are several commands for region trimming. Some use the
 <p>
   There are several commands for region trimming. Some use the

-  <a href="/ardours-interface/the-edit-point-control/">edit point</a> to determine where
+  <a href="@@edit-point-control">edit point</a> to determine where

   to trim to. Some are not bound to any keys by default (but could be via the
   to trim to. Some are not bound to any keys by default (but could be via the

-  Keybindings Editor).
+  <a href="@@default-keyboard-bindings">Keybindings Editor</a>).

 </p>
 </p>

-
-<dl class="wide-table">
-  <dt><kbd class="menu">Region/trim-front</kbd> <kbd>j</kbd></dt>
-  <dd>Trim selected region(s) start to edit point.</dd>
-  <dt><kbd class="menu">Region/trim-end</kbd> <kbd>k</kbd></dt>
-  <dd>Trim selected region(s) end to edit point.</dd>
-</dl>
-
-<h2 id="trimtonextprevious">Trim to Next/Previous Region</h2>

 <p>
 <p>

-  Sometimes you just want to extend the start or end of region so that it reaches
-  the end or start of an adjacent region. There is now an operation accessible
-  from the region context menu, under <kbd class="menu">Edit &gt;Trim &gt; Trim to
-  Next</kbd> or <kbd class="menu">Edit &gt; Trim &gt; Trim to Previous</kbd>. This
-  will extend the selected regions so they directly adjoin their neighbours, unless
-  their source files are not long enough, in which case they will be extended to the
-  maximum possible. Trim to Next will extend the end of the selected regions to the
-  start of the next region; Trim to Previous will extend the start of the selected
-  regions to the end of the previous region.
+  These command are both in the <kbd class="menu">Region &gt; Trim</kbd> main menu
+  (with a region selected) or in the context menu of a region, <kbd class="menu">
+  <kbd class="mouse">right</kbd> click on a region &gt; <em>Name_Of_The_Region</em>
+  &gt; Trim</kbd>

 </p>
 </p>

-<dl class="wide-table">
-  <dt><kbd class="menu">Region/trim-to-previous-region</kbd> <kbd class="mod1">j</kbd></dt>
-  <dd>Trim the start of selected region(s) to the end of the previous
-  region.</dd>
-  <dt><kbd class="menu">Region/trim-to-next-region</kbd> <kbd class="mod1">k</kbd></dt>
-  <dd>Trim the end of selected region(s) to the start of the following
-  region.</dd>
-</dl>

 
 

-<h2>Other Possible Commands for Trimming</h2>
-<p>
-  These are not bound to any keys by default, but could be via the Keybindings
-  Editor. They can also be sent via OSC or other control protocols.
-</p>
-<dl class="wide-table">
-  <dt><kbd class="menu">Region/trim-region-to-loop</kbd></dt>
-  <dd>Trim region to match the current loop range.</dd>
-  <dt><kbd class="menu">Region/trim-region-to-punch</kbd></dt>
-  <dd>Trim region to match the current punch range.</dd>
-</dl>
+<table class="dl">
+  <tr><th><dfn>Trim Start at Edit Point</dfn> (<kbd>j</kbd>)</th>
+  <td>Trim selected region(s) start to edit point.</td></tr>
+  <tr><th><dfn>Trim End at Edit Point</dfn> (<kbd>k</kbd>)</th>
+  <td>Trim selected region(s) end to edit point.</td></tr>
+  <tr><th><dfn>Trim to Loop/Punch</dfn></th>
+  <td>Trim selected region(s) beginning and end to the loop/punch boundaries (if it exists).</td></tr>
+  <tr><th><dfn>Trim to Previous</dfn> (<kbd class="mod1">j</kbd>)</th>
+  <td>Trim the start of selected region(s) to the end of the previous region.
+    If the region is too short, it is extended to its maximum to the left.</td></tr>
+  <tr><th><dfn>Trim to Next</dfn> (<kbd class="mod1">k</kbd>)</th>
+  <td>Trim the end of selected region(s) to the start of the following region.
+    If the region is too short, it is extended to its maximum to the right.</td></tr>
+</table>