whitespace change to test commit hook

[ardour-manual] / include / add-new-notes.html

diff --git a/include/add-new-notes.html b/include/add-new-notes.html
index 41aa8ad933fc6a9bd31ef76db9fddc74737d6365..62b260c36f0cb9b476ef385756cf2e89aa0e1211 100644 (file)
--- a/include/add-new-notes.html
+++ b/include/add-new-notes.html
@@ -1,31 +1,54 @@
 
-<h2>Adding new notes</h2>
-<p>
-  For light MIDI editing, you can use the Internal Edit Mode. 
-  This mode lets you select notes, copy, move or delete them and alter their
-  properties (see below). To <em>add</em> notes using the mouse, <kbd class="mouse mod1">Left</kbd>-drag. 
-  
-  For more extensive MIDI editing, you may prefer <kbd class="menu">Draw Mode</kbd>. 
-  You can click or drag to add a new note, without having to hold down Ctrl. However, 
-  Draw Mode doesn't offer region-level editing.
+<p>
+  MIDI notes can be added a few different way in Ardour:
+<p>
+
+<h2 id="add-new-notes-using-the-mouse">Using the mouse</h2>
+
+<p>
+  Drawing notes with the mouse requires that a MIDI track <a
+  href="@@create-midi-tracks">exists</a>, and a blank MIDI region has
+  been <a href="@@create-midi-regions">created</a> in this track.
+</p>
+<p>
+  In either <em>Draw</em> or <em>Internal Edit</em> <a
+  href="@@toolbox">Mode</a> new notes can be added with a click or
+  drag: a mouse <em>click</em> creates a note at the pointer location
+  (or the nearest grid anchor if grid is enabled), and its duration is
+  one <a href="@@grid-controls">Grid unit</a>. A mouse <em>drag</em>
+  creates the note like a click does, but allows continuously setting
+  the duration of the note until the mouse button is released.
 </p>
 
-<p>So, to summarize:</p>
-<table class="dl">
-    <tr><th>Selecting, moving, copying, trimming, deleting <em>regions</em></th>
-        <td><kbd class="menu">Note Level Editing</kbd> disabled, using object,
-        range or other mouse modes</td></tr>
-    <tr><th>Selecting, moving, copying trimming, deleting <em>notes</em></th>
-        <td><kbd class="menu">Note Level Editing</kbd> enabled, and using mouse object mode</td></tr>
-    <tr><th>Adding new notes</th>
-        <td>enabling "Note Level Editing" and then either
-          <ul>
-            <li>using mouse object mode and <kbd class="mouse mod1">Left</kbd>-drag, or</li>
-            <li>using mouse draw mode.</li>
-          </ul>
-        </td></tr>
-</table>
-<p>
-  Note that there is also <a href="@@step-entry">a step entry editor</a> allowing to
-  enter notes from a virtual keyboard and lots more besides.
+<h2 id="add-new-notes-using-step-entry">Using Step Entry</h2>
+
+<p>
+  The <a href="@@step-entry">Step Entry editor</a> allows to enter a
+  melody in sequence along time, using a virtual keyboard and specific
+  controls. It can be a very handy and fast way create MIDI lines, in a
+  kind of typewriter way, all the more when using its different
+  keyboard shortcuts.
+</p>
+<p>
+  The Step Entry window is shown by <kbd class="mouse">right</kbd>
+  clicking the record button in the <a
+  href="@@midi-track-controls">MIDI track header</a> and selecting <kbd
+  class="menu">Step Entry</kbd>. This will automatically create a MIDI
+  region to type into at the playhead position, which will automatically expand at each step.
+</p>
+
+<h2 id="add-new-notes-using-the-virtual-keyboard">Using the Virtual Keyboard</h2>
+
+<p>
+  The <a href="@@virtual-keyboard">Virtual MIDI Keyboard</a> &mdash; or
+  a real MIDI keyboard plugged in as the tracks input &mdash; can be
+  used to record MIDI, as a microphone would record audio.
+</p>
+<p>
+  It can be started by choosing the <kbd class="menu">Window &gt;
+  Virtual Keyboard</kbd> menu. Exactly like for audio recording, the
+  track(s) must be armed for recording, the main record engaged, then
+  the transport started. As for the Step Entry, a MIDI region will be
+  auto-generated at the playhead position, and expanded as long as the
+  recording lasts.
 </p>