Ruler/Markers rewrite, part 2 of N

[ardour-manual] / include / ruler.html

diff --git a/include/ruler.html b/include/ruler.html
index 3381605a88a01fd9f2482efde45164038cccd979..b34e9c6ae65e5b68a3bc9cb4db21fb04f1c798e4 100644 (file)
--- a/include/ruler.html
+++ b/include/ruler.html
@@ -7,39 +7,90 @@
 </figure>
 
 
-<p> The <dfn>Ruler</dfn> scales the session along time, allows navigating, and
+<p>
+  The <dfn>ruler</dfn> scales the session along time, allows navigating, and
   can be marked for different uses.
 </p>
 <p>
-  One of its main uses is to move the playhead:
-  clicking anywhere on the timeline will bring the playhead at this location in
-  time. Also, using the mouse's scrollwheel while hovering the Ruler will zoom in
-  or out (<kbd class="mouse">&uArr;</kbd>/<kbd class="mouse">&dArr;</kbd> ).
+  One of its main uses is to move the playhead: clicking anywhere on the
+  timeline will bring the playhead at this location in time. Also, using the
+  mouse's scrollwheel while hovering the ruler will zoom in or out
+  (<kbd class="mouse">&uArr;</kbd>/<kbd class="mouse">&dArr;</kbd> ).
 </p>
 <p>
-  The Ruler is made of a succession of rows, each having a special role related to
-  time. Adding or removing rows can be done by <kbd class="mouse">right</kbd> clicking
-  anywhere in the ruler's header on the left, and ticking any of:
+  The ruler is made of a succession of rows, each having a special role related
+  to time. Adding or removing rows can be done by <kbd class="mouse">right</kbd>
+  clicking anywhere in the ruler's header on the left, and ticking any of:
 </p>
 
 <table class="dl">
-  <tr><th><dfn>Mins:Secs</dfn></th><td>scaling the session with the Mins:Secs:mSec notation</td></tr>
-  <tr><th><dfn>Timecode</dfn></th><td>scaling the session with the Hours:Mins:Secs:Frames notation</td></tr>
-  <tr><th><dfn>Samples</dfn></th><td>scaling the session with the sample number notation</td></tr>
-  <tr><th><dfn>Bars:Beats</dfn></th><td>slicing the time according to the time signature of the Meter</td></tr>
-       <tr><th><dfn>Meter</dfb></th><td>shows the time signature. It can be changed along the timeline, by <kbd class="mouse">Right click</kbd> &gt; <kbd class="menu">New Meter</kbd>. The Bars:Beats ruler will reflect the change.</td></tr>
-       <tr><th><dfn>Tempo</dfn></th><td>shows the BPM. It can be changed along the timeline, by <kbd class="mouse">Right click</kbd> &gt; <kbd class="menu">New Tempo</kbd>. The Bars:Beats ruler will reflect the change.</td></tr>
-       <tr><th><dfn>Range Markers</dfn></th><td>allow to create and modify ranges directly on the Ruler.</td></tr>
-       <tr><th><dfn>Loop/Punch Ranges</dfn></th><td>are special kind of ranges designed to be played as a loop and to do punch recording, i.e. recording on a precise section of time, respectively.</td></tr>
-       <tr><th><dfn>CD Markers</dfn></th><td>are markers designed to be used while creating a recording that has to be split in time, as an audio CD</td></tr>
-       <tr><th><dfn>Location Markers</dfn></th><td>is meant to receive any kind of marker, user generated or from Ardour itself.</td></tr>
-  <tr><th><dfn>Video Timeline</dfn></th><td>shows thumbnails of the <a href="@@video-timeline-and-monitoring">video</a> in the timeline</td></tr>
+  <tr>
+    <th><dfn>Mins:Secs</dfn></th>
+    <td>scaling the session with the Mins:Secs:mSec notation</td>
+  </tr>
+  <tr>
+    <th><dfn>Timecode</dfn></th>
+    <td>scaling the session with the Hours:Mins:Secs:Frames notation</td>
+  </tr>
+  <tr>
+    <th><dfn>Samples</dfn></th>
+    <td>scaling the session with the sample number notation</td>
+  </tr>
+  <tr>
+    <th><dfn>Bars:Beats</dfn></th>
+    <td>slicing the time according to the time signature</td>
+  </tr>
+       <tr>
+    <th><dfn>Time Signature</dfb></th>
+    <td>shows the time signature. It can be changed along the timeline, by
+    <kbd class="mouse">Right-click</kbd> &gt;
+    <kbd class="menu">New Time Signature</kbd>. The Bars:Beats ruler will
+    reflect the change.</td>
+  </tr>
+       <tr>
+    <th><dfn>Tempo</dfn></th>
+    <td>shows the BPM. It can be changed along the timeline, by
+    <kbd class="mouse">Right-click</kbd> &gt; <kbd class="menu">New Tempo</kbd>.
+    The Bars:Beats ruler will reflect the change.</td>
+  </tr>
+       <tr>
+    <th><dfn>Range Markers</dfn></th>
+    <td>allow to create and modify ranges directly on the Ruler.</td>
+  </tr>
+       <tr>
+    <th><dfn>Loop/Punch Ranges</dfn></th>
+    <td>are special kind of ranges designed to be played as a loop and to do
+    punch recording, i.e. recording on a precise section of time, respectively.</td>
+  </tr>
+       <tr>
+    <th><dfn>CD Markers</dfn></th>
+    <td>are markers designed to be used while creating a recording that has
+    to be split in time, as an audio CD</td>
+  </tr>
+  <tr>
+    <th><dfn>Location Markers</dfn></th>
+    <td>is meant to receive any kind of marker, user generated or from Ardour
+    itself.</td>
+  </tr>
+  <tr>
+    <th><dfn>Cue Markers</dfn></th>
+    <td>allows triggering entire cues from the grid in the <em>Cue</em>window</td>
+  </tr>
+  <tr>
+    <th><dfn>Video Timeline</dfn></th>
+    <td>shows thumbnails of the <a href="@@video-timeline-and-monitoring">video</a>
+    in the timeline</td>
+  </tr>
 </table>
 
 <p>
-  Most of the operations on the markers are described in <a
-  href="@@working-with-markers">Working with Markers</a>, while the Meter,
-  Tempo, Bars:Beats and Timecode use are described in <a
-  href="@@tempo-and-meter">Tempo and Meter</a>.
+  Most rulers allow placing markers to serve a specific purpose: mark a point in
+  time, define a loop range, or something else entirely.
 </p>
 
+<p>
+  Most of the operations on the markers are described in <a
+  href="@@working-with-markers">Working with Markers</a>, additional information
+  on Time Signature, Tempo, Bars:Beats, and Timecode is available in the
+  <a href="@@tempo-and-meter">Tempo and Time Signature</a> chapter.
+</p>