Ruler/Markers rewrite, part 5 of N

[ardour-manual] / include / note-selection.html

diff --git a/include/note-selection.html b/include/note-selection.html
index f3bb0a98169410193c653c2d8e9b58b70d2556d8..1fa590cb1261f79d7eee4e89f2b6bf3f5bb69e24 100644 (file)
--- a/include/note-selection.html
+++ b/include/note-selection.html
@@ -1,44 +1,35 @@
 
-<h2>Selecting/Navigating note-by-note</h2>
+<h2>Navigating/Selecting notes with the keyboard</h2>
+
 <p>
-  Tab selects the next note. <kbd class="mod1">Tab</kbd> selects the previous 
-  note. <kbd class="mod3">Tab</kbd> or <kbd class="mod13">Tab</kbd> adds 
-  the next/previous note to the selection.
+  <kbd>tab</kbd> selects the next note in a MIDI region, while <kbd
+  class="mod1">tab</kbd> selects the previous note. Holding down the <kbd
+  class="mod3"></kbd> key as well prevents previously visited notes from being
+  deselected.
 </p>
 
 <h2>Selecting notes with the mouse</h2>
+
 <p>
-  While in mouse object mode, you can click on a note to select it. Once you 
-  have selected one note, <kbd class="mouse mod3">Left</kbd>-click on another 
-  to select all notes between them. To add or remove a note to/from the 
-  selection, click <kbd class="mouse mod1">Left</kbd>. You can also click and 
-  drag outside of a note to <dfn>rubberband select</dfn> a series of notes.
+  While in <a href="@@toolbox">Object Mode</a>, any note can be clicked on to select it. Once a note has been selected, <kbd class="mouse mod3">left</kbd>-clicking on another note selects all notes between the first note selected and the second one. Adding or removing a note to or from the selection is done by <kbd class="mouse mod1">left</kbd>-clicking it. Clicking and dragging outside of a note will <dfn>rubberband select</dfn> any notes enclosed by the selection rectangle; holding down the <kbd class="mod3n"></kbd> key will prevent any previously selected notes from being deselected.
 </p>
+
 <p>
-  Three different selection operations are possible if you switch to mouse 
-  range mode:
+  In any mode, <kbd class="mod3 mouse">left</kbd>-clicking on a note on the
+  Scroomer (the piano header of the track, see <a
+  href="@@midi-track-controls">MIDI Track Controls</a>) will add all
+  occurrences of that note to the selection, while <kbd
+  class="mouse">middle</kbd>-clicking will only select/deselect all occurrences
+  of that note, clearing the previous selection. Scroomer selections work on
+  all MIDI regions of a track at once.
 </p>
-<ul>
-  <li>
-    Vertical drags within the MIDI region will select all notes within the 
-    spanned note range.
-  </li>
-  <li>
-    Clicks on the piano header of the track (if visible &mdash; the track must 
-    be tall enough to display it) will select all occurences of that note.
-  </li>
-  <li>
-    Drags on the piano header of the track will select all notes within the 
-    spanned note range.
-  </li>
-</ul>
 
 <h2>Listening to Selected Notes</h2>
+
 <p>
-  If <kbd class="menu">Edit &gt; Preferences &gt; MIDI &gt; Sound MIDI notes 
-  as they are selected</kbd> is enabled, Ardour will send a pair of 
-  NoteOn/NoteOff messages through the track, which will typically allow you to 
-  hear each note as it is selected.
+  If <kbd class="menu">Edit &gt; Preferences &gt; MIDI &gt; Sound MIDI notes as
+  they are selected</kbd> is enabled, Ardour will send a pair of NoteOn/NoteOff
+  messages through the track as notes are selected. Assuming there is an
+  appropriate device or synthesizer attached to the track, these should be
+  audible.
 </p>
-  
-