Cue: Cue window elements

[ardour-manual] / include / controlling-playback.html

diff --git a/include/controlling-playback.html b/include/controlling-playback.html
index 84185e068947f474096162d0d07d17db28def983..5db534d5d1440762fefb9a09b4fe8fdb5b617593 100644 (file)
--- a/include/controlling-playback.html
+++ b/include/controlling-playback.html
@@ -1,56 +1,61 @@
 
-<h2>Positioning the Playhead</h2>
+<figure class="right">
+  <img src="/images/the-playhead.png" alt="The playhead">
+  <figcaption>
+    The playhead
+  </figcaption>
+</figure>
 
 <p>
-  The <dfn>playhead</dfn> is a vertical line with two arrows at each end
-  that indicates the current position of playback.
+  The <dfn>playhead</dfn> is a red vertical line that indicates the current
+  position of playback.
 </p>
 
+<h2>Positioning the Playhead</h2>
+
 <h3>Positioning the playhead at the current pointer position</h3>
 <p>
   Pressing <kbd>P</kbd> will set the playhead to the current position of
-  the pointer, if it is within the editor track area.
+  the mouse pointer, if it is within the editor track area.
 </p>
 
 <h3>Positioning the playhead on the timeline</h3>
 <p>
-  A <kbd class="mouse">Left</kbd> click anywhere on the timeline (rulers)
+  A <kbd class="mouse">Left</kbd> click anywhere on the <a href="@@ruler">Ruler</a>
   will move the playhead to that position.
 </p>
 
 <h3>Positioning the playhead with the transport clocks</h3>
 <p>
-  Click on either the primary or secondary transport clock and
-  <a href="/introducing-ardour/basic-gui-operations/editing-clocks/">edit their value</a> 
-  to move the playhead to a specific position.
+  Clicking on either the primary or secondary transport clock and
+  <a href="@@editing-clocks">editing their value</a> moves the playhead to a
+  specific position.
 </p>
 
 <h3>Positioning the playhead at a marker</h3>
 <p>
-  Click <kbd class="mouse">Right</kbd> on the marker and select either
-  <kbd class="menu">Locate to here</kbd> or <kbd class="menu">Play from
-  here</kbd>.
+  <kbd class="mouse">Right</kbd> clicking on the marker and selecting either
+  <kbd class="menu">Locate to Here</kbd> or <kbd class="menu">Play from
+  Here</kbd> will place the playhead at the marker's position.
 </p>
 <p>
-  Alternatively, place the pointer on the marker and press
-  <kbd>P</kbd> to set the playhead.
+  Alternatively, placing the mouse pointer on the marker and pressing
+  <kbd>P</kbd> sets the playhead precisely on the marker location.
 </p>
 
 
 <h2>Looping the Transport</h2>
 
 <p>
-  When the <dfn>loop transport</dfn> button is pressed, the playhead will
-  jump the start of the loop range, and continue to the end of that range
-  before returning to the start and repeating.
-  While looping, a light green area is displayed in the time ruler over
-  the tracks to show the loop range.
+  When the <a href="@@the-loop-range">loop transport</a> button is pressed, the
+  playhead will jump the start of the loop range, and continue to the end of that
+  range before returning to the start and repeating.
 </p>
 <p>
-  By default, looping is bound to the <kbd>l</kbd> key.
+  While looping, a light green area is displayed in the Ruler over the tracks to
+  show the loop range.
 </p>
 <p>
-  For more information on defining and altering the loop range see
-  <a href="/working-with-markers/loop-range/">Loop Range Markers</a>.
+  By default, looping is bound to the <kbd>l</kbd> key.
 </p>