Ruler/Markers rewrite, part 5 of N

- Rewrite Location Markers
- Update documentation on some other marker types
- Update TOC/menu to stop listing outdated pages (they are still built)

include/bbt-markers.html

@@ -8,9 +8,9 @@
 
 <p>
   To create a new BBT marker, <kbd class="mod1n"></kbd>-click on the
-  Bars:Beats ruler. This will open a dialog titled 'New Music Time' where you
-  can name the marker and define what bar (left field) and beat (right field)
-  this marker should reset the time to.
+  Bars:Beats ruler. This will open a dialog titled <kbd class="window">New Music
+  Time</kbd> where you can name the marker and define what bar (left field) and
+  beat (right field) this marker should reset the time to.
 </p>
 
 <figure>

include/creating-location-markers.html

@@ -1,14 +1,25 @@
 
 <p>
   <dfn>Location Markers</dfn> appear in the <a href="@@ruler">Locations Markers
-  ruler</a> at the top  of the timeline. The green
-  <dfn style="background-color:limegreen;">begin</dfn> and
-  <dfn style="background-color:limegreen;">end</dfn> markers, that define the length of the session, appear
-  automatically, but yellow <span style="background-color:gold;">custom</span> markers can be created at any position in a
-  session.
+  ruler</a> at the top of the timeline. They have multiple uses, most
+  commonly&nbsp;&mdash; for navigation in a session, e.g. where this or that
+  instrument should start/stop playing. Custom markers can be created at
+  any position in a session.
 </p>
+
 <p>
-  There are multiple ways to create custom markers at the current playhead position:
+  The <dfn style="background-color:limegreen;">start</dfn> and
+  <dfn style="background-color:limegreen;">end</dfn> markers, that define the
+  length of the session, appear automatically once any content has been added to
+  the session (either recorded or imported). The end marker automatically shifts
+  to the right once more material gets added.
+</p>
+
+<h2>Creating Location Markers</h2>
+
+<p>
+  There are multiple ways to create custom markers at the current playhead
+  position:
 </p>
 <ul>
   <li>using the keyboard shortcut (default is <kbd>Tab</kbd></li>
@@ -17,8 +28,8 @@
 </ul>
 
 <p>
-  Adding a marker at an arbitrary location on the timeline (i.e. not at the playhead
-  position) can also be done either by:
+  Adding a marker at an arbitrary location on the timeline (i.e. not at the
+  playhead position) can also be done either by:
 </p>
 <ul>
   <li><kbd class="mouse">right</kbd> clicking in the Location Marker ruler, and
@@ -28,3 +39,124 @@
   clock widget</a> to set its position.</li>
 </ul>
 
+<h2>Moving Location Markers</h2>
+
+<p>
+  <kbd class="mouse">Left</kbd>-clicking and dragging moves a single marker to a
+  new location on the timeline.
+</p>
+
+<p>
+  It is possible to move multiple markers by the same distance. <kbd
+  class="mouse mod1">Left</kbd>-clicking each marker creates a selection of
+  markers that can be dragged left or right together.
+</p>
+
+<h2>Renaming Location Markers</h2>
+
+<p>
+  There are three ways to rename a location marker:
+</p>
+
+<ol>
+  <li>
+    Double-click on a marker opens a dialog where a new name can be submitted.
+  </li>
+  <li>
+    Right-clicking on a marker and selecting <kbd class="menu">Rename….</kbd>
+    opens a dialog where a new name can be submitted.
+  </li>
+  <li>
+    Editing and confirming the name by pressing <kbd class="button">Enter</kbd>
+    in an entry box in the <em>Ranges&nbsp;&amp; Marks</em> sidebar.
+  </li>
+</ol>
+
+<h2>Removing Location Markers</h2>
+
+<p>
+  There are three ways to remove a location marker:
+</p>
+
+<ol>
+  <li>
+    Hovering the marker and pressing <kbd class="button">Enter</kbd>.
+  </li>
+  <li>
+    Right-clicking on a marker and selecting <kbd class="menu">Remove</kbd>.
+  </li>
+  <li>
+    Clicking the <kbd class="button">x</kbd> for a marker of choice in the
+    <em>Ranges&nbsp;&amp; Marks</em> sidebar.
+  </li>
+</ol>
+
+<h2>More Options</h2>
+
+<p>
+  The context (right-click) menu for location markers has more options than the
+  ones mentioned above:
+</p>
+
+<table class="dl">
+  <tr>
+    <th>Locate to Here</th>
+    <td>
+      Moves the playhead to the selected marker.
+    </td>
+  </tr>
+  <tr>
+    <th>Play from Here</th>
+    <td>
+      Moves the playhead to the selected marker and starts playback.
+    </td>
+  </tr>
+  <tr>
+    <th>Move Mark to Playhead</th>
+    <td>
+      This changes the position of the selected marker to that of the playhead.
+    </td>
+  </tr>
+  <tr>
+    <th>Create Range to next Marker</th>
+    <td>
+      This creates a pair of range markers between the selected marker and the
+      next one to the right on the timeline.
+    </td>
+  </tr>
+  <tr>
+    <th>Promote to Time Origin</th>
+    <td>
+      This makes the position of the chosen range marker the origin time. This
+      is mostly useful when the <em>Display delta to origin marker</em> clock
+      mode is enabled to display the difference between current playhead
+      position and the origin time. Absolute time stays unaffected.
+    </td>
+  </tr>
+  <tr>
+    <th>Hide</th>
+    <td>
+      This hides the selected marker from the ruler until the user chooses to
+      unhide it.
+    </td>
+  </tr>
+  <tr>
+    <th>Rename…</th>
+    <td>
+      This opens a dialog to rename the marker.
+    </td>
+  </tr>
+  <tr>
+    <th>Lock</th>
+    <td>
+      This prevents a marker from being accidentally moved elsewhere.
+    </td>
+  </tr>
+  <tr>
+    <th>Glue to Bars and Beats</th>
+    <td>
+      When this option is enabled, the marker maintains its position in bars
+      and beats even if there are changes in tempo and meter.
+    </td>
+  </tr>
+</table>

include/creating-range-markers.html

@@ -66,7 +66,7 @@
   </li>
   <li>
     By clicking the markers' <kbd class="button">x</kbd> button in the
-    <em>Ranges &amp Marks</em> sidebar.
+    <em>Ranges&nbsp;&amp; Marks</em> sidebar.
   </li>
 </ol>
 

include/cue-markers.html

@@ -33,8 +33,29 @@
 <h2>Moving Cue Markers</h2>
 
 <p>
-  Just like any other marker, a cue marker can be picked and relocated by
-  dragging it left or right.
+  <kbd class="mouse">Left</kbd>-clicking and dragging moves a single marker to a
+  new location on the timeline.
+</p>
+
+<p>
+  It is possible to move multiple markers by the same distance. <kbd
+  class="mouse mod1">Left</kbd>-clicking each marker creates a selection of
+  markers that can be dragged left or right together.
+</p>
+
+<h2>Single marker</h2>
+<p>
+  <kbd class="mouse">Left</kbd>-clicking and dragging moves a single marker to a
+  new location on the timeline.
+</p>
+
+<h2>Multiple markers</h2>
+<p>
+  It is possible to move multiple markers by the same distance. <kbd
+  class="mouse mod1">Left</kbd>-clicking each discreet marker, or <kbd
+  class="mouse mod3">Left</kbd>-clicking the first and last markers of a range
+  of markers selects them, then dragging one to a new location will move all
+  selected markers together.
 </p>
 
 <h2>Stopping All Cues</h2>

include/working-with-markers.html

@@ -130,7 +130,7 @@
 <h2>Removing Markers</h2>
 
 <p>
-  There are two ways to permanently delete a marker. The first one is to
+  There are three ways to permanently delete a marker. The first one is to
   right-click the marker of choice, then select
   <kbd class="menu">Remove</kbd> in the menu.
 </p>
@@ -147,6 +147,11 @@
   pointer, then press <kbd class="key">Del</kbd>.
 </p>
 
+<p>
+  The third way is to click the markers' <kbd class="button">x</kbd> button in
+  the <em>Ranges&nbsp;&amp; Marks</em> sidebar.
+</p>
+
 <h2>Additional Actions</h2>
 
 <p>

master-doc.txt

@@ -520,7 +520,7 @@ part: subchapter
 ---
 
 ---
-title: Working With Markers
+title: Markers Basics
 include: working-with-markers.html
 link: working-with-markers
 uri: working-with-markers