- In general, most MIDI editing will probably be done with the mouse in object
- mode. This allows to select notes, copy, move or delete them and alter their
- properties (see below). But at some point, <em>adding</em> notes to a MIDI
- region using the mouse will mean dragging with the mouse. Since this would
- normally be a selection operation if the mouse is in object mode, there needs
- to be some way to tell Ardour that the user is trying to <dfn>draw</dfn> new
- notes within a MIDI region. Ardour provides two ways do this. One is to leave
- the mouse in object mode and <kbd class="mouse mod1">Left</kbd>-drag. The
- other, useful to enter a lot of notes for a while, is to switch the mouse into
- <kbd class="menu">Draw Notes</kbd> mode, which will now interpret any drags
- and clicks as requests to add a new note. For obvious reasons, Draw Notes mode
- can not be used while using region-level editing.
+ For light MIDI editing, the Internal Edit Mode can be used. This mode allows
+ to select notes, copy, move or delete them and alter their properties. Adding
+ new notes in this mode is done by <kbd class="mouse
+ mod1">Left</kbd> dragging.
+
+ For more extensive MIDI editing, the <kbd class="menu">Draw Mode</kbd>.
+ allows to <kbd class="mouse">Left</kbd> click or drag to add a new note, without
+ having to hold down <kbd class="mod1n"></kbd>. However, Draw Mode doesn't offer
+ region-level editing nor rubberband selection.
+</p>
+
+<p>
+ In both modes, a mouse <em>click</em> creates a note at the pointer location
+ (or the nearest grid point if grid is enabled), and its duration is one <a
+ href="@@grid-controls">Grid unit</a>, even if the grid is disabled. A mouse
+ <em>drag</em> creates the note like a click does, but allows to set the
+ duration of the note until the mouse button is released.