From 248440e975ea65df0f1c524fcebea1999908ff6c Mon Sep 17 00:00:00 2001
From: Paul Davis <paul@linuxaudiosystems.com>
Date: Tue, 27 Sep 2016 14:53:13 -0500
Subject: [PATCH] document scale mode for the push2

---
 .../06_Abelton_Push2.html                     | 46 ++++++++++++++++++-
 1 file changed, 45 insertions(+), 1 deletion(-)

diff --git a/_manual/22_using-control-surfaces/06_Abelton_Push2.html b/_manual/22_using-control-surfaces/06_Abelton_Push2.html
index 0e8c26a..baee947 100644
--- a/_manual/22_using-control-surfaces/06_Abelton_Push2.html
+++ b/_manual/22_using-control-surfaces/06_Abelton_Push2.html
@@ -188,7 +188,7 @@ menu_title: Ableton Push 2
   mode, press the "Mix" button.
 </p>
 <p>
-  <img alt="track mix mode on Push2 screen" src="/images/push2-trackmix.png">
+
 </p>
 <p>
   In Track Mix mode, various aspects of the state of the first
@@ -217,6 +217,50 @@ menu_title: Ableton Push 2
   video display.
 </p>
 
+<h2>Scale Selection</h2>
+<p>
+  Press the Scale button to enter Scale mode. The display will look
+  like this:
+</p>
+<p>
+  <img alt="track mix mode on Push2 screen"
+       src="/images/push2-scale.png">
+</p>
+<p>
+  In the center, 37 scales are presented. Scroll through them by
+  either using the cursor/arrow keys to the lower right of the
+  display, or the knobs above the display. The scale will change
+  dynamically as you scroll. You can also scroll in whole pages using
+  the upper right and upper left buttons above the display (they will
+  display "<" and ">" if scrolling is possible).
+</p>
+<p>
+  To change the root note of the scale, press the corresponding button
+  above or below the video display.The button will be lit to indicate
+  your selection (and the text will be highlighted).
+</p>
+<p>
+  By default, Ardour configures the Push 2 pads to use "in-key" mode,
+  where all pads correspond to notes "in" the chosen scale. Notes
+  corresponding to the root note, or the equivalent note in higher
+  octaves, are highlighted with the color of the current target MIDI
+  track.
+</p>
+<p>
+  In
+  "chromatic" mode, the pads correspond to a continuous sequence of
+  notes starting with your selected root note. Pads corresponding to
+  notes in the scale are illuminated; those corresponding to the root
+  note are lit with the color the current target MIDI track. Other
+  pads are left dark, but you can still play them.
+</p>
+<p>
+  To switch between them, press button on the lower left of the video
+  display; the text above it will display the current mode (though it
+  is usually visually self-evident from the pad lighting pattern).
+</p>
+  
+
 <h2>Specific Button/Knob Functions</h2>
 
 <p>
-- 
2.37.2