diff --git a/include/controlling-midi-range.html b/include/controlling-midi-range.html
new file mode 100644
index 00000000..9c099901
--- /dev/null
+++ b/include/controlling-midi-range.html
@@ -0,0 +1,36 @@
+
+
+ The visible note range in a MIDI track can be controlled in two
+ principle ways: the note scroomer, or the scroll wheel of your
+ mouse.
+
+
+
Using the scroomer
+
+
+ The scroomer offers two kinds of control. You can "grab" it in the
+ middle and move it up or down - this adjusts the absolute note range
+ displayed up or down. Alternatively you can "grab" the top or bottom
+ handle of the scroomer, and move that up or down - this adjusts the
+ extent of the note range displayed.
+
+
+
+
Using your scroll wheel
+
+
+
+ Several scroll operations can be used to control the visible note
+ range:
+
In internal edit mode, with no notes selected, unmodified
+ scrolling will move the visible range up and down.
+
scroll will increase and decrease the
+ visible range (zoom out and in)
+
scroll will expand either the top or
+ bottom of the visible note range (depending on scroll
+ direction). Think of this as "show me higher pitches" or "show me
+ lower pitches".
+
diff --git a/include/edit-midi.html b/include/edit-midi.html
index 5dc4592c..683d11c2 100644
--- a/include/edit-midi.html
+++ b/include/edit-midi.html
@@ -14,17 +14,11 @@
window or pane. Notes are edited right where they appear.
- Editing note information in Ardour occurs in only a single region. There is
- no way currently to edit note data for multiple regions at the same time;
- so, for example, notes cannot be selected in several regions and then all
- deleted, nor can they be copied and pasted from one region to another.
- Regions, however, can be copied and pasted just as with audio.
-
-
- When using jackd as the audio server for Ardour, all MIDI I/O is done
- via JACK for sample accurate timing and maximal efficiency when communicating
- with external software synthesizers. Otherwise, Ardour connects to midi
- via the existing OS MIDI system.
+ Editing note information in Ardour occurs in only a single
+ region. There is no way currently to edit note data for multiple
+ regions at the same time; so, for example, notes cannot be
+ selected in several regions at once and then all deleted. However
+ they can they be copied and pasted from one region to another.
Every MIDI track has its own MIDI port for input; it may have an
@@ -44,9 +38,11 @@
There is a Normal and a Percussive mode for note data editing.
- The vertical dimension of the region window is controlled by a
+ The visible note range is controlled by a
scroomer widget, which is a combination scroll/zoom tool for
- altering the zoom level and range of visible MIDI data.
+ altering the zoom level and range of visible MIDI data. When in
+ internal edit mode, you can also use scroll operations to adjust
+ the visible range in various ways.
diff --git a/master-doc.txt b/master-doc.txt
index 90e20259..33c61b8b 100644
--- a/master-doc.txt
+++ b/master-doc.txt
@@ -1378,6 +1378,14 @@ uri: working-with-midi
part: chapter
---
+---
+title: Adding New Notes
+include: controlling-midi-range.html
+link: controlling-midi-range
+uri: working-with-midi/controlling-midi-range
+part: subchapter
+---
+
---
title: Adding New Notes
include: add-new-notes.html
diff --git a/source/images/midi-scroomer.png b/source/images/midi-scroomer.png
new file mode 100644
index 00000000..14202c5f
Binary files /dev/null and b/source/images/midi-scroomer.png differ