From: Alexandre Prokoudine <alexandre.prokoudine@gmail.com>
Date: Wed, 9 Nov 2022 11:10:24 +0000 (+0300)
Subject: Ruler/markers rewrite part 7 of N
X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?p=ardour-manual;a=commitdiff_plain;h=50934bd0f4075a9aabdbbd99ca9bb5ffc061e6c0

Ruler/markers rewrite part 7 of N

Update Range Markers with info on ruler interaction
---

diff --git a/include/creating-range-markers.html b/include/creating-range-markers.html
index 205efc1..4439654 100644
--- a/include/creating-range-markers.html
+++ b/include/creating-range-markers.html
@@ -3,40 +3,69 @@
   <dfn>Range markers</dfn> are essentially two
   <a href="@@creating-location-markers"> location markers</a> that appear in the
   <a href="@@ruler">Range Markers</a> ruler, and are grouped together to mark
-  the beginning and end of a section in the timeline.
+  the beginning and end of a section on the timeline.
 </p>
 
 <h2>Creating a Range on the Timeline</h2>
 
 <p>
-  Creating a new <dfn>range</dfn> can be done by <kbd class="mouse">right</kbd>
-  clicking on the Range Markers ruler at the top
-  of the timeline, then selecting <kbd class="menu">New Range</kbd>. Two markers
-  with the same name and opposing arrows will appear along the ruler.
-</p>
-<p>
-  It is also possible to create range markers from a selected range or
-  region in the Editor window, or to using the
-  <kbd class="menu">Ranges&nbsp;&amp; Marks List</kbd> in the Editor list.
+  There are multiple ways to create range markers:
 </p>
 
+<ul>
+  <li>
+    <kbd class="mouse">Right</kbd>-clicking on the Range Markers ruler at the
+    top of the timeline, then selecting <kbd class="menu">New Range</kbd>.
+  </li>
+  <li>
+    <kbd class="mouse mod1">Left</kbd>-clicking and dragging right on the Range
+    Markers ruler. This will render a red-filled area across all tracks and
+    busses to help preview the extent of the range in creation. Once the mouse
+    button is released, a paired range marker will be created.
+  </li>
+  <li>
+    Selecting a range in the Editor window, then
+    <kbd class="mouse">right</kbd>-clicking and selecting
+    <kbd class="menu">Add Range Markers</kbd>.
+  </li>
+  <li>
+    Clicking <kbd class="button">New Range</kbd> button at the bottom of the
+    <kbd class="window">Ranges&nbsp;&amp; Marks</kbd> sidebar. The markers will
+    be created around the playhead position, unless the playhead in at the time
+    origin (in which case the markers will be placed at the time origin
+    position).
+  </li>
+  <li>
+    <kbd class="mouse">Right</kbd>-clicking a location or a CD marker and
+    selecting <kbd class="menu">Create Range to Next Marker</kbd>. This will
+    create a pair of range markers that start at the selected marked and end at
+    the position of the next location or CD marker (both rulers are taken into
+    account).
+  </li>
+</ul>
+
 <h2>Editing a Range</h2>
 
 <p>
   Both markers of a range can be independently moved along the timeline by
-  clicking and dragging them to the desired location.
+  clicking and dragging them to the desired location. They can also be moved
+  together by <kbd class="mod2n"></kbd>-dragging one of the markers.
 </p>
+
 <p>
-  They can also be moved together by <kbd class="mod2n"></kbd>-dragging one marker.
+  Any pair or range markers, including session start/end markers, can be
+  repositioned to the extents of an existing range selection on the timeline by 
+  <kbd class="mouse">right</kbd>-clicking on either of the markers and selecting
+  <kbd class="menu">Set Range from Selection</kbd> in the menu.
 </p>
 
 <h3>Renaming Range Markers</h3>
 
 <p>
-  Ardour provides two ways to rename an existing pair of range markers:
+  Ardour provides several ways to rename an existing pair of range markers:
 </p>
 
-<ol>
+<ul>
   <li>
     Double-clicking either of the two range markers will show a dialog for
     setting a new caption for the markers.
@@ -45,15 +74,19 @@
     The same can be achieved by right-clicking on either of the markers and
     selecting the <kbd class="menu">Rename Range…</kbd> menu item.
   </li>
-</ol>
+  <li>
+    Additionally, the name can be edited in the
+    <kbd class="window">Ranges&nbsp;&amp; Marks</kbd> sidebar.
+  </li>
+</ul>
 
 <h2>Removing Range Markers</h2>
 
 <p>
-  Range markers can be deleted in three ways:
+  Range markers can be deleted in several ways:
 </p>
 
-<ol>
+<ul>
   <li>
     By clicking on one of the markers and pressing the <kbd>Del</kbd> key.
   </li>
@@ -65,7 +98,12 @@
     By clicking the markers' <kbd class="button">x</kbd> button in the
     <em>Ranges&nbsp;&amp; Marks</em> sidebar.
   </li>
-</ol>
+</ul>
+
+<p>
+  Additionally, all ranges can be removed at once by
+  <kbd class="mouse">right</kbd>-clicking on an empty part of the Range Markers
+  ruler and selecting the <kbd class="menu">Clear All Ranges</kbd> menu item.
 
 <h2>More Options</h2>
 
@@ -106,12 +144,6 @@
       Changes the position of the selected marker to that of the playhead.
     </td>
   </tr>
-  <tr>
-    <th>Set Range from Selection</th>
-    <td>
-      Adjusts the position of range markers to match the current selection.
-    </td>
-  </tr>
   <tr>
     <th>Zoom to Range</th>
     <td>