X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Fgeneric-midi-learn.html;h=51a7a7b6cf20c157b8587ed3721feac1cdca9df7;hb=ace9646b0217c7e7e8314b82799e5e23889d14c7;hp=f941b1bf47158bec5e26621948239d2d7acb0089;hpb=720f72d3e5375376fddb4650c41e851dc82114db;p=ardour-manual

diff --git a/include/generic-midi-learn.html b/include/generic-midi-learn.html
index f941b1b..51a7a7b 100644
--- a/include/generic-midi-learn.html
+++ b/include/generic-midi-learn.html
@@ -5,17 +5,6 @@ There are no "best" ways to map an arbitrary MIDI controller for
 controlling Ardour. There may be very legitimate reasons for different
 users to prefer quite different mappings.
 </p>
-<p>
-On every platform that Ardour runs on, there are excellent
-free-of-charge tools for making connections between MIDI hardware and
-"virtual" MIDI ports like the ones that Ardour creates and
-uses. Rather than waste precious developer time replicating these
-connection/patch managers, we prefer to leverage their existence by
-having users rely on them to actually connect Ardour to other MIDI
-devices and software. On OS X, we recommend Pete Yandell's MIDI
-Patchbay. On Linux, a wide variety of tools are available including
-QJackctl, aconnect, Patchage, and more.
-</p>
 
 <h2>Basics</h2>
 
@@ -31,6 +20,26 @@ QJackctl, aconnect, Patchage, and more.
   <li>The binding is complete. Moving the hardware should control the Ardour fader etc. </li>
 </ol>
 
+<p>
+There's a complication to this story, however. You cannot use MIDI
+learn with the GUI provided by the plugin. This is true no matter what
+the plugin format or platform is. When we refer to "whatever on-screen
+fader ..." above, we are referring to an “Ardour-owned” control of
+some sort. You can get access to that in one of 3 ways:
+
+<ul>
+  <li>right click on the processor element in the mixer strip, and choose “Edit with Generic GUI”</li>
+  <li>right click on the processor element in the mixer strip, and from “Controls”, make the desired parameter visible inline in the mixer strip</li>
+  <li>in the editor, click on the “A” (automation) button for the
+  track, find the desired parameter. This will make the automation
+  lane for that parameter visible, and it comes with a fader you can
+    use for MIDI learn.</li>
+</ul>
+
+You can’t just “click the GUI” because the plugin owns the GUI, and
+cannot (and should not) be a part of the MIDI learn process.
+</p>
+
 <h2>Cancelling a Learned MIDI Binding</h2>
 
 <p>