X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Fselection-and-punch-clocks.html;h=b7a9cc00a279ca33c47ca588e3373ec22dea0310;hb=a61fbacdfcb7a76fe425fada61f49fc85751e47a;hp=1390c88593fff8e5fb99bb9dd3f3812b2e3530f9;hpb=2098e011e638b5c86c56e68df7757975fc4d728f;p=ardour-manual

diff --git a/include/selection-and-punch-clocks.html b/include/selection-and-punch-clocks.html
index 1390c88..b7a9cc0 100644
--- a/include/selection-and-punch-clocks.html
+++ b/include/selection-and-punch-clocks.html
@@ -1,28 +1,78 @@
+<h2 id="selection_clocks">The Selection Clocks</h2>
 
-<img src="/images/selectionpunchclocks.png" alt="An image of the the selection and punch clocks in Ardour" />
+<figure>
+    <img src="/images/selection-clocks.png" alt="The range clocks">
+    <figcaption>
+      The range clocks
+    </figcaption>
+</figure>
 
 <p>
-  The transport bar contains a set of 5 clocks that show the current
-  <dfn>selection range</dfn> and <dfn>punch ranges</dfn>.
+  The current <dfn>selection range</dfn>, as set with the <a href="@@toolbox">Range Mode tool</a>,
+  is displayed in these three clocks: start of the range, end of the range, and length.
 </p>
 <p>
-  Clicking on the punch range clocks will locate to either the beginning or end of the punch range.
-  Similarly, clicking on the range clocks will locate to either the beginning
-  or end of the current selection. In this screen shot there is no current
-  selection range, so the selection clocks show an "off" state.
+  Clicking on the range clocks will locate to either the beginning or end of the punch range.
 </p>
+<p>
+  <kbd class="mouse">Right</kbd> clicking on any of the clocks brings up a context menu
+  allowing to change the type of time display between the <a href="@@editing-clocks">
+  4 clock modes</a>, and to copy the selected clock's time to the clipboard.
+</p>
+
+<h2 id="punch_controls">The Punch Controls &amp; clocks</h2>
+
+<figure>
+  <img src="/images/punch-controls.png" alt="The punch controls">
+  <img src="/images/punch-clocks.png" alt="The punch clocks">
+  <figcaption>
+    The Punch Controls, and the related Punch clocks
+  </figcaption>
+</figure>
+
+<p>
+  The punch controls available in the main toolbar, work in conjunction with the
+  punch clocks, only visible while in Editor Mode.
+</p>
+
 <p>
   The <kbd class="menu">In</kbd> and <kbd class="menu">Out</kbd> buttons relate
   to the Punch range, and allow to use only one of the two punch boundaries, or both:
 </p>
-<dl>
-  <dt>In only</dt><dd>Records from the In marker on, without a end boundary</dd>
-  <dt>Out only</dt><dd>Records untils the Out marker, without a beginning boundary</dd>
-  <dt>In only</dt><dd>Records only between the In and Out markers</dd>
-</dl>
+<table class="dl">
+  <tr><th>In only</th><td>Records from the In marker on, without a end boundary</td></tr>
+  <tr><th>Out only</th><td>Records until the Out marker, without a beginning boundary</td></tr>
+  <tr><th>In <em>and</em> Out</th><td>Records only between the In and Out markers</td></tr>
+</table>
+
 <p>
-  <kbd class="mouse">Right</kbd> clicking on any of the 5 clocks brings up a context menu
-  allowing to change the type of time display between the <a href="/introducing-ardour/basic-gui-operations/editing-clocks/">
-  4 clock modes</a>, and to copy the selected clock's time to the clipboard.
+  The punch clocks can be controlled the same way as the range clocks (moving the playhead,
+  and changing the display mode).
+</p>
+
+<h2 id="rec-mode">Recording mode</h2>
+
+<p>
+  The <kbd class="menu">Rec</kbd> button affects how the tracks behave when recording:
+</p>
+
+<table class="dl">
+  <tr><th>Non-Layered OFF <em>(default)</em></th>
+  <td>Tracks in <dfn>normal mode</dfn> will record non-destructively &mdash;
+  new data is written to new files, and when overdubbing, new regions will be
+  layered on top of existing ones. This is the recommended mode for most workflows.
+  </td></tr>
+  <tr><th>Non-Layered ON</th>
+  <td>Tracks using <dfn>non-layered mode</dfn> will record non-destructively
+  &mdash; new data is written to new files, but when overdubbing, the existing
+  regions are trimmed so that there are no overlaps. This does not affect
+  the previously recorded audio data, and trimmed regions can be expanded
+  again at will. Non-layered mode can be very useful for spoken word material,
+  especially in combination with <a href="@@pushpull-trimming">push/pull trimming</a>.
+  </td></tr>
+</table>
+
+<p>
+  See <a href="@@track-types">Track Modes</a> for more information.
 </p>